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Note 


Before using this information and the product it supports, be sure to read the general information under “Notices” 
on page xxi. 


5494 Microcode 


In this document, the term code refers to microcode. 
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Notices 


Trademarks 
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that IBM intends to make these available in all countries in which IBM operates. 
Any reference to an IBM product, program, or service is not intended to state or 
imply that only IBM’s product, program, or service may be used. Any functionally 
equivalent product, program, or service that does not infringe any of IBM’s 
intellectual property rights may be used instead of the IBM product, program, or 
service. Evaluation and verification of operation in conjunction with other products, 
except those expressly designated by IBM, is the user’s responsibility. 


IBM may have patents or pending patent applications covering subject matter in 
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About This Manual 


This manual describes how the IBM 5494 Remote Control Unit uses Systems 
Network Architecture (SNA), Synchronous Data Link Control (SDLC), X.25, X.21, 
token-ring, or Ethernet to communicate with the Application System/400 (AS/400) 
system. In addition, this manual describes how the 5494 manages the attached 
workstations and converts network data streams into protocols for 
nonprogrammable workstations (NWSs) and printers. 


This manual supplies information about the 5494 required by the systems 
programmer to: | 


e Generate valid output data streams 
e Process input data streams 
e Evaluate network error conditions. 


Who Should Read This Manual 


This manual is for the programmer who is familiar with SNA and communication 
protocols. This manual does not contain a comprehensive overview of SNA, SDLC, 
X.25, X.21, or LAN protocols. To find more information on these subjects, see 
“Related Publications” on page xxv. 


How This Manual Is Organized 


Chapter 1, Introduction to the 5494 Remote Control Unit 
This chapter briefly describes the 5494 and provides an overview of how the 5494 
communicates with both the AS/400 system and workstations. 


Chapter 2, Synchronous Data Link Control Support 
This chapter describes the SDLC support provided by the 5494. 


Chapter 3, X.25 Packet Switched Network Support 
This chapter describes the X.25 support provided by the 5494. 


Chapter 4, X.21 Switched Public Data Network Support 
This chapter describes the X.21 support provided by the 5494. 


Chapter 5, V.25 bis Serial Automatic Calling Support 
This chapter describes the V.25 bis support provided by the 5494. 


Chapter 6, LAN Support for Token-Ring and Ethernet 
This chapter provides information about 5494 support for attachment to token-ring 
and Ethernet networks. 


Chapter 7, Frame-Relay Support 
This chapter provides information about 5494 support for Frame-Relay networks. 


Chapter 8, Type 2.1 Node Support 
This chapter provides information about 5494 support for the Type 2.1 (T2.1) node. 


Chapter 9, SNA Subarea Network Support 
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This chapter describes how to communicate with an AS/400 system through an 


SNA subarea network. 


Chapter 10, Nonprogrammable Workstation Support 
This chapter provides the functional details for nonpregremmable workstation 
(NWSs) attached to the 5494. 


Chapter 11, 5250 Shared Addressing 
This chapter provides the functional details for the twinaxial shared addressing 
support between the 5494 and the AS/400 system. 


Chapter 12, Programmable Workstation Support 


This chapter provides the functional details for programmable workstation (PWSs) 


attached to the 5494. 


Chapter 13, Systems Network Architecture Support 
This chapter describes the SNA support provided by the 5494. 


Chapter 14, Network Management Support 
This chapter discusses the 5494 SNA alert functions and the Response Time 
Monitor (RTM) features. 


Chapter 15, Display Data Streams 
This chapter describes the format of display data streams supported by the 5494. 


Chapter 16, Keyboard Functions 
This chapter describes the keyboard modes and functions supported by the 5494. 


Chapter 17, Display Pointer Device (Mouse) Support 
This chapter describes the pointer device (mouse) characteristics and functions 
supported by the 5494. 


Chapter 18, Printer Data Streams 
This chapter describes the format of printer data streams supported by the 5494. 


Chapter 19, Communication Interfaces 
This chapter describes the EIA 232D, X.21, and V.35 phvaicalsi interfaces supported 
by the 5494. 


Appendix A, Ildeographic Enhancements 
This appendix contains information about ideographic data entry and processing. 
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Related Publications 


The following publications contain related information: 


5494 Library 


Cabling 


IBM 5494 Remote Control Unit Planning Guide, GA27-3936 

IBM 5494 Remote Control Unit User’s Guide, GA27-3960 

IBM 5494 Remote Control Unit Functions Reference, SC30-3533 
IBM 5494 Remote Control Unit Maintenance Information, SY27-0327 


IBM 5494 Remote Control Unit Problem Determination Guide Quick Reference, 
GA27-3909 


IBM 5494 Remote Control Unit National Language Support for Arabic, 
GA27-3910 


IBM 5494 Remote Control Unit National Language Support for Hebrew, 
GA27-3911 


LAN Cabling System Planning and Installation Guide, GA27-3361 


IBM Cabling System Problem Determination Guide for Twinaxial Applications, 
GA21-9491 


IBM 5299 Terminal Multiconnector Model 3 Planning, Installation and Problem 
Analysis Guide, GA27-3749 


Using the Cabling System with Communication Products, GA27-3620 
Cabling System Optical Fiber Planning and Installation Guide, GA27-3943 


Application alte (AS/400) 


IBM AS/400 Communications: Configuration, SC41-3401 

IBM AS/400 Local Area Network Support, SC41-3404 

IBM AS/400 X.25 Network Support, SC41-3405 

IBM AS/400 Communication: Management, SC41-3406 

IBM AS/400 Workstation Customization Programming, SC41-3605 
IBM AS/400 Programming: Performance Tools/400, SC41-3340 
IBM AS/400 Programming: Work Management, SC41-3306 

IBM AS/400 Remote Work Station Support, SC4t -3402 


Communication/Protocols 


Data Communications Concepts, GC21-5169 
Implementation of X.21 Interface, General Information Manual, GA27-3287 
Synchronous Data Link Control Concepts, GA27-3093 


The X.25 Interface for Attaching SNA Nodes to Packet-Switched Data Networks 
General Information Manual, GA27-3345 
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IBM Local Area Network Administrator's Guide, GA27-3748 
IBM Local Area Network Concepts and Products, GG24-3178 


The Ethernet: A Local Area Network, Version 2.0, November, 1982, 
XNSS-018211, Third Printing, 1985 


IBM Multisegment LAN Design Guidelines, GG24-3398 

IBM Token-Ring Network Installation Guide, GA27-3678 

IBM Token-Ring Network Architecture Reference, SC30-3374 

IBM Token-Ring Network Guide to Small Networks, SK2T-0300 

IBM Token-Ring Network Introduction and Planning Guide, GA27-3677 
IEEE 802.3 Local Area Network Considerations, GG22-9422 


LAN Technical Reference: IEEE 802.2 and NetBIOS RP PUCAEON Program 
Interfaces, SC30-3587 


LAN Technical Reference: Ethernet Adapter Interface, SC30-3661 
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Summary of Changes 


Fifth Edition (August 1995) 
This manual supports the IBM 5494 Remote Control Unit Release 3.1. 


Where applicable, information has been added for: 
¢ Frame Relay Communications 
¢ Concurrent host attachment using a single physical link 
e 5250 Video Delivery | 


Technical changes or additions to the text and illustrations are indicated by a 
vertical line to the left of the change. 
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Chapter 1. Introduction to the 5494 Remote Control Unit 


This chapter briefly describes the IBM 5494 Remote Control Unit and provides an 
overview of how the 5494 communicates with both the Application System/400 
(AS/400) system and workstations. 


Description of the 5494 


The 5494 controls communication between the workstations and the AS/400 
system. Using the 5494, one AS/400 system can serve the local site, as well as 
multiple remote sites. Using concurrent host attachment, the 5494 can 
communicate with up to four AS/400 systems at a time. 


In addition to being a communication controller, the 5494 is an editing controller. 
As an editing controller, the 5494 processes: 


e Display data streams from the AS/400 system to workstation displays 

e Keystrokes from the workstations 

e Print data streams from the AS/400 system to printers 

e |Ideographic character data streams from ideographic workstations to the 


AS/400 system. 


This local processing improves response time and reduces the processing load on 


the AS/400 system. 


5494 Communication with the AS/400 System 


The 5494 communicates with the AS/400 system through a Type 2.1 (T2.1) 
connection using any of the following physical interfaces: 


© EIA 232D (V.24/V.28) 


e V.35 
e X.21 
e Token-ring 


e Ethernet (BNC, RJ-45, or 15-pin D-SUB) 


The 5494 supports the following communication protocols for link establishment and 
end-to-end communication with the AS/400 system: 


X.21 switched 


V.25 bis 


SDLC 
X.25 


Token-Ring 


Ethernet 
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For automatic call establishment when using an X.21 physical 
interface. 


For automatic call establishment when using an EIA 232D 
(V.24/V.28) physical interface. 


For end-to-end link communication with the AS/400 system. 


For communication with the AS/400 system through a packet 
switched network. 


For communication with the AS/400 system through a 
token-ring network. 


For communication with the AS/400 system through an Ethernet 
network. 


1-1 


Frame Relay For communication with the AS/400 system through a 
| frame-relay network. 


SNA For exchange of information with the AS/400 system. The 5494 
communicates with the AS/400 through Systems Network 
Architecture (SNA) LU 6.2 sessions. For programmable 
workstations (PWSs), the 5494 supports end node 
pass-through. For nonprogrammable workstations (NWSs), the 
5494 encapsulates SNA LU 4 printer sessions and SNA LU 7 
display sessions within SNA LU 6.2 sessions. 


Network Options 


The 5494 can interface with a communications network, a local area network 
(LAN), or both. 


Communications Network Options 
For the 5494, the interface with the communications network includes transceiver 
electronics inside the 5494, a physical connector at the back of the 5494, a 
communications cable, and either a modem or data circuit-terminating equipment 
(DCE) that is external to the 5494. Although all models use the same 26- pin | 
connector block at the back of the 5494, each type of communications eae has a 
different combination of signal lines. 


LAN Options 


A Token-Ring Upgrade kit and an Ethernet Upgrade kit are available for the 5494. 
The Token-Ring Upgrade kit includes a 5494 Token-Ring Adapter and a 
communications cable and connects to an external multistation access unit 
(MSAU). The Ethernet Upgrade kit includes a 5494 Ethernet Adapter and a 
T-connector which can be used with a 10BASE2 connection. The Ethernet adapter 
may alternatively use 10OBASE5 or 10BASE-T connections. 


Network Attachment 
The 5494 can attach to several different types of communication networks, 
Table 1-1 shows the interface requirements, communication protocols, and 
corresponding 5494 cable type for each of these networks. The 5494 always uses 
SNA protocols in its operation. For more information about network services and 
requirements, contact individual network suppliers. 


Table 1-1 (Page 1 of 2). Networks Supported by the 5494 


Communication 5494 


Network Interface Requirements Protocol Cable Type 

Analog switched or leased EIA 232D interface with synchronous §SDLC or EIA 232D 
modem V.25 bis/SDLC 

X.21 Public Data Network switched or EIA 232D interface with X.21 bis SDLC EIA 232D 

leased DCE 

X.25 Packet Switched Network V .24/28 interface with X.21 bis DCE X.25 EIA 232D 

X.21 Public Data Network leased X.21 interface with X.21 DCE SDLC X.21 

X.21 Public Data Network switched X.21 interface with X.21 DCE X.21/SDLC X.21 

X.25 Packet Switched Network X.21 interface with X.21 DCE X.25 X.21 
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Table 1-1 (Page 2 of 2). Networks Supported by the 5494 


Network 
High-Speed Analog 


Fractional T1 

Dataphone Digital Service 

X.21 Public Data Network switched or 
leased 


X.25 Packet Switched Network 
Token-Ring Network 


Ethernet Network 


Frame-Relay Network 


Frame-Relay Network 


Interface Requirements 
V.35 interface 


V.35 Interface with Fractional T1 
Multiplexer 


V.35 interface with Data Service Unit 
(DSU) : | 


V.35 interface with X.21 bis DCE 


V.35 interface with X.21 bis DCE 
Token-Ring IEEE 802.5 


Ethernet IEEE 802.3 
or Ethernet DIX Version 2.0 
X.21 interface with X.21 DCE 


V.35 interface 


Communication with Workstations 


The 5494 can support up to eight twinaxial ports for attaching workstations. A 
maximum of seven workstations can be attached to any port, for a maximum of 56 
workstations. The 5494 with a LAN adapter (token-ring or Ethernet) allows either of 
the following types of attachment: 


e Attachment of the 5494 to a LAN to which the AS/400 system is attached (LAN 
AS/400 Attachment configuration) 


Communication 
Protocol 


SDLC 
SDLC 


SDLC 


SDLC 


X.25 


Token-Ring IEEE 
802.2 


Ethernet IEEE 
802.2 


Frame Relay 
IEEE 802.2 


Frame Relay 
IEEE 802.2 


5494 


Cable Type 
V.35 
V.35 


V.35 


V.35 


V.35 
Token-Ring 


User-supplied 


X.21 


V.35 


¢ Attachment of workstations on a LAN to a 5494 (LAN Gateway configuration). 


In a LAN Gateway configuration, the 5494 supports as many as 80 workstations. 
As many as 56 of these workstations can be attached to the 5494 through twinaxial 
ports if the Twinaxial Expansion Kit is installed, or 28 workstations if it is not. The 
remainder (or all 80 workstations) can be attached to the 5494 through a LAN. 


Refer to the 5494 Remote Control Unit Planning Guide for information about 
suggested configurations and additional device support. 


Chapter 1. Introduction to the 5494 Remote Control Unit 1-3 


1-4 Functions Reference 





Chapter 2. Synchronous Data Link Control Support 


SDLC is a protocol that manages code-transparent, serial-by-bit information transfer 
between nodes that are joined by data links. SDLC supports data transmission in 
only one direction at a time (referred to as half-duplex transmission). The 5494 is 
always the secondary station and the AS/400 system is the primary station. 


The link connection can be a point-to-point or multipoint configuration. A 
point-to-point link can be leased or switched. SDLC includes comprehensive 
detection and recovery procedures for transmission errors that may occur on the 
link. 


This chapter describes only those components of SDLC implemented in the 5494. 
For a comprehensive description of SDLC, refer to Synchronous Data Link Control 
Concepts. 


Note: In this book, all data strings are presented with the most significant byte on 
the left. Byte and bit numbers are also written from left to right beginning with byte 
O bit O as the most significant bit. 


Physical Line Attachment Considerations 


The following information provides an overview of SDLC line attachment options. 


Physical Lines Supported 


The 5494 supports SDLC over the following types of communications lines: 


Leased through the following interfaces: 


Physical Interfaces Line Speeds 

EIA 232D (CCITT V.24/V.28) 2400 through 19200 bps 
CCITT V.35 2400 through 128000 bps 
CCITT X.21 2400 through 128000 bps 


Switched through the following interfaces: 


Physical Interfaces Line Speeds 

EIA 232D (CCITT V.24/V.28)' 2400 through 19200 bps 
CCITT V.35 2400 through 128000 bps 
CCITT X.212 2400 through 128000 bps 


1 Automatic call procedures using the V.25 bis protocol can be used to establish a connection on a switched line. Once the 
end-to-end connection is made, SDLC protocols are used for link communications. For a detailed description of V.25 bis auto-dial 
protocol support, see Chapter 5, “V.25 bis Serial Automatic Calling Support.” 


2 Call procedures using the X.21 switched protocol are used to establish a connection. Once the end-to-end connection is made, 
SDLC protocols are used for link communications. For a detailed description of X.21 switched protocol support, see Chapter 4, 
“X.21 Switched Public Data Network Support.” 
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Zero-Bit Insertion 


DCE Support 


The 5494 communications adapter performs zero-bit insertion/deletion on 
transmitted and received frames in order to maintain the uniqueness of beginning 
and ending flags. | 


The 5494 supports only synchronous DCEs (modems). Synchronous DCEs 
provide the transmit and receive clocks for the data terminal equipment (DTE). 


Transmission Encoding 


The 5494 supports both non-return-to-zero (NRZ) and non-return-to-zero inverted 
(NRZI) encoding of transmitted and received data. NRZ/NRZI operation is set in 
user configuration. 


NRZI encoding is needed for certain DCEs to prevent extended periods of 
transitionless data due to transmission of contiguous 0 bits. NRZ is recommended 
for use on digital networks and with digital DCEs. 


For NRZ/NRZI considerations during V.25 bis call setup, see Chapter 5, “V.25 bis 
Serial Automatic Calling Support.” 


Automatic Retraining Sequences 


Certain DCEs (modems) drop their ready for sending (RFS) signal during an 
automatic retraining sequence. 


The 5494 tolerates the loss of the RFS signal for up to 10 seconds on a duplex 
point-to-point line. 


Switched Network Considerations 


The following sections discuss considerations for switched network 
communications. 


Operator Network Interface 
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SDLC is designed to provide end-to-end communication services and requires links 
between all participating stations to be active and in their data-transfer state. 


SDLC does not provide switched-link call placement services. The 5494 does, 
however, support two forms of call placement to use with SDLC, depending on the 
network used, and the modem or DCE used to effect data transfer. These services 
are: 


e X.21 
e V.25 bis. 


Table 1-1 on page 1-2 shows the configurations supporting each of these 
circuit-switched protocols. Chapter 4, “X.21 Switched Public Data Network 
Support” describes the functional and operational characteristics of the X.21 
protocol. Chapter 5, “V.25 bis Serial Automatic Calling Support” describes those 
associated with the V.25 bis protocols. 


For detailed information on using the operator network interface, refer to the /BM 
5494 Remote Control Unit User’s Guide. 


Switched Line Connection Sequence 


The connection sequence occurs following startup and following any disconnection 
of the line. 


The 5494 supports two switched network connection modes. The chosen mode is 
set during user configuration. The 5494 and the attached DCE must support the 
same connection modes. 


Data Terminal Ready (DTR) (108.2): In this mode, the 5494 enables the DTR 
signal to indicate the 5494’s readiness to accept a call or to enter a data-transfer 
state. The 5494 then monitors the line at 50-millisecond intervals for an enabled 
data set ready (DSR) signal that indicates entry into a data-transfer state. To guard 
against DSR bounce conditions, DSR operation is monitored for a minimum of 50 
milliseconds. 


Connect Data Set to Line (CDSTL) (108.1): In this mode, the 5494 waits for an 
enabled calling indicator (Cl) that shows the presence of an incoming call, or for an 
enabled DSR that indicates the DCE’s readiness to enter into the data-transfer 
state. After monitoring for a bounce condition (20 milliseconds for Cl, 50 
milliseconds for DSR), the 5494 enables the CDSTL line and waits for DSR, if DSR 
is not already on. DSR must be turned on within 10 seconds of the time that Cl is 
turned on for a call to be accepted. 


Switched Line Disconnection 
The 5494 drops DTR and request to send (RTS) to initiate a switched line 
disconnection in the following situations: 


e Immediately after receiving an SDLC Disconnect (DISC) command and 
returning an unnumbered acknowledgment (UA) response. 


¢ Following a Receive or Transmit inactivity timeout. For more information, see 
“Timeout Conditions” on page 4-6. 


e Following the loss of the DSR signal from the DCE (modem). 


Echo Suppressors and Cancelers 
A 500-millisecond line quiet period is provided before enabling the RTS signal each 
time a call is attempted on a half-duplex switched line. This is done to enable any 
echo suppressors used in the circuit. | 


A 500-millisecond white noise transmission period is provided after activating RTS 


and before transmitting data each time a call is attempted on a switched line. This 
is done to allow time for any echo cancelers in the transmission path to converge. 
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X.21 Network Considerations 


The following additional network considerations are valid for SDLC operation on an 
X.21 public network: , 


Support Characteristics: SDLC operation on an X.21 leased network through 
the X.21 or X.21 bis interface is supported through a duplex point-to-point or 
multipoint connection. 


Ready State: The DCE-ready state or activation of the indicate (I) signal 
shows that the DCE is ready for operation. The 5494 presents the DTE-ready 
state to show that it is ready for operation and activates the control (C) signal 
to indicate readiness for transmission. 


Multipoint Operation: For multipoint operation on an X.21 interface, the 5494 
waits for a minimum of 24 bit-times between setting the control (C) signal active 
and transmission of data. 


SDLC Transmissions 
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All transmissions using SDLC are carried in frames. The frame contains all the 
commands, responses, and information that are being transmitted. Frames are 
transmitted one at a time or grouped together and sent in a sequence. 


lf frames are transmitted one at a time with the poll bit set, response frames are 
returned by the receiving station for each frame received. If a sequence of frames 
is transmitted, the poll bit is set only in the last frame and the receiving station 
responds only after receiving the last frame in the sequence. 


When transmitting sequenced frames, the transmitting station counts and numbers 
each frame. This count is the Ns count. The station receiving the sequenced 
frames counts each error-free frame it receives. This count is the Nr count. 


The Ns and Nr counters start at O and count through 7. When the counter is at 7 
and another frame is counted, the counter advances to 0. 
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Frame Format 


Figure 2-1 shows the organization of an SDLC frame. The transmission frame is 
bounded by a unique flag sequence. The 5494 recognizes the transmission of 
continuous flags as interframe time fill. 
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Figure 2-1. SDLC Frame Organization 


Leading Pad 


This field, although not a part of the SDLC frame, is shown here because of its 
relationship with the frame. When the leading pad required bit is set in the 
configuration record, the SDLC adapter inserts a synchronization byte into the data 
stream before the starting flag sequence. The leading pad byte is used to obtain or 
maintain synchronization of the modem clock following a line turnaround. 


Starting Flag 
The starting flag starts the frame. The starting flag also causes transmission error 
checking to start with the first nonflag character. It is made up of 8 bits with a 
configuration of X'7E' (B'01111110'). This flag serves as a reference to show the 
position of the address and the control fields. 


Address Field 


The address (A) field of the SDLC frame always contains the network address of 
the 5494, whether the 5494 is transmitting to or receiving from the AS/400 system. 
The 5494 recognizes and responds to a broadcast address (all bits set) as well as 
to its own network address. 
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Control Field 


The control (C) field of an SDLC frame defines the frame’s function. The 5494 
supports three types of SDLC commands and responses: 


e Unnumbered commands and responses 
e Supervisory commands and responses 
e Sequenced information (I) frames. 


See “SDLC Commands” on page 2-7 for a description of the control field encoding 
for each of these frame types. 


The 5494 supports modulo 8 frame numbering and an 8-bit control field. The 5494 
does not support modulo 128 frame numbering or the extended (16-bit) control field 
format. 


Information Field 


The information (Il) field is not present in all frames. The I-field can be of variable 
length, but it is restricted to an integral number of 8-bit bytes and by the buffering 
limits of the stations communicating with each other. Maximum I-field length is 
specified in the XID command and response sequence (1033 bytes for the 5494). 
The I-field contains the data to be moved over the data link from place to place in 
the network. The data in this field is checked for validity by the frame check 
sequence field. 


Frame Check Sequence 


Ending Flag 


SDLC uses a bit accounting method called cyclic redundancy check (CRC) to 
ensure data validity. The transmitting unit applies a mathematical formula to the A-, 
C-, and I-fields of the frame and places the 16-bit result in the frame check 
sequence (FCS) field prior to transmission. The receiving unit applies the same 
formula and compares the results. If the result differs from the transmitted FCS, 
the receiving unit discards the frame. The erroneous frame and all subsequent 
frames are retransmitted. Refer to Synchronous Data Link Control Concepts for the 
FCS-generating polynomial and its applications. 


The ending flag ends the frame and transmission error checking. It is made up of 8 
bits with a configuration of X'7E' (B'01111110'). When more than one frame is 
transmitted, the ending flag of one frame can also be the starting flag of the next 
frame. | 
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SDLC Commands 


The 5494 supports three types of SDLC commands. Some commands contain 
information unique to the 5494. 


Supported Command Types 
The 5494 supports the following types of SDLC commands: 


Unnumbered commands and responses: These commands handle mode 
setting, reporting, and transmission tests. 


Supervisory commands and responses: These commands are responsible 
for traffic management. They acknowledge sequenced I-frames and indicate 
when the receiving station is ready to accept additional frames. 


Information frames: These frames carry the SNA information. 


Figure 2-2 shows the control field format and application of each supported SDLC 
frame. 
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Disconnected mode. 
This station is offline. 


Disconnect. Enter Normal 
Disconnect mode (go on 
hook if switched). 


Request Disconnect. This 
station wants to 
disconnect. 


Unnumbered Acknowledgment. 


Acknowledge U commands. 


Frame Reject. 

invalid command received; 
must receive SNRM or DISC 

to reset FRMR condition. 
Exchange Station Identification. 


Test. Used to test a link. The 


X 
X 
X 
X 
X 
l-field may contain test data. 


xX | X X Receive Ready. The sender 
is ready to receive. 

X | X X Receive Not Ready. The sender 
is not ready to receive. 


1 


i” 





U = unnumbered, S = supervisory, | = information. 





Figure 2-2. SDLC Commands and Responses 
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Commands Containing 5494 Information 


2-8 


The XID, FRMR, TEST, and I-frame commands contain data that is unique to the 
5494 in the information field. 


XID Command 

The 5494 accepts a null XID command (that is, an XID command with no I-field) or 
an XID3 command, and responds with an XID3 response. For more information, 
see Chapter 8, “Type 2.1 Node Support.” | 


FRMR Command | 
Frames received with a valid FCS can still be erroneous. The 5494 considers 
frames not valid if: 


e The C-field specifies a command that is unsupported or not valid 

The |-field was too long to fit into the receiving station buffers 

e An I-field was included with a command in which I-fields are not allowed 

e A sequenced I-frame was received with an unexpected sequence number. 


After receiving a frame that is not valid, the 5494 returns a FRMR command stating 
the cause. The FRMR command is sent with a 3-byte description of the frame that 
is not valid immediately following the control field. Table 2-1 shows the format for 
the FRMR response. 


Table 2-1. FRMR Format 


Byte Description 
0 The C-field of the rejected frame 
1 .  B‘Nr \O \Ns \0°: 


Nr = The 3-bit receive count prior to the rejected frame 


Ns = The 3-bit send count prior to the rejected frame 


“2 B'0000zyxw' 


Functions Reference 


z= Sequencing error 
y= __|-field longer than that supported by the 5494 (>1033 bytes) 
x= Illegal I-field is present 


w= Unsupported command or command that is not valid has been received 


TEST Command 

The TEST command is sent by the AS/400 system to. solicit a TEST response from 
the 5494. This command may contain an optional I-field. The 5494 returns a 
TEST response containing a copy of this I-field. 


l-Frame Command 

The I|-frames contain the SNA path information units (PIU). For more information 
about the contents of the I-frame, see Chapter 13, “Systems Network Architecture 
Support.” | 


Timeout Error Recovery 
The 5494 tracks the following SDLC timeout conditions: 


Receive Inactivity Timeout: If 30 seconds elapse without receiving an SDLC 
frame, the 5494 checks the interface. The DSR signal and the clock signals are 
verified. If either is inactive, the 5494 goes to Normal Disconnected mode and 
posts an operator error. 


Transmit Inactivity Timeout: If the 5494 is unable to transmit its response within 
30 seconds because of a link problem (DSR, RFS or Clear to Send [or CTS], or 
clock signal inactive), it goes to Normal Disconnected mode and posts an operator 
error. 


Note: Link recovery can be initiated by the primary station only. 


For more information about SDLC, refer to Synchronous Data Link Control 
Concepts. 


Error Reporting 


Because SDLC provides its own error recovery system, recoverable errors are not 
reported directly to the operator. However, the 5494 maintains statistical counters. 
The AS/400 system requests the counters and the 5494 reports them with the SNA 
commands REQMS and RECFMS, respectively. For more information on these 
commands, see Chapter 13, “Systems Network Architecture Support.” For more 
information concerning the 5494 error handling strategy and error summary, refer to 
the IBM 5494 Remote Control Unit User’s Guide. 


Operating Modes 
SDLC supports two operating modes: 


Normal Response mode (NRM): The 5494 is in NRM after receiving a set 
normal response mode (SNRM) command from the AS/400 system. I|-frames 
are exchanged in this mode. 


Normal Disconnected mode (NDM): The 5494 is in NDM after receiving a 
DISC command from the AS/400 system. Once in this mode, the 5494 
responds only to SNRM, XID, DISC, and TEST commands. The 5494 returns 
a disconnected mode (DM) response to all other commands until an SNRM is 
received. | 
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Chapter 3. X.25 Packet Switched Network Support 





X.25 uses a communications process called packet switching, which routes and 
transfers user data and control information. The information transmitted is 
contained in packets that identify the sender and receiver by a unique address. 
The communication line within the X.25 network is busy only during the 
transmission of a packet. Once this operation is accomplished, the line is released 
for the use of other packets. 


Packet switched data networks (PSDNs), such as an X.25 network, allow multiple 
users to share communication lines or channels. PSDNs are an alternative to 
networks made up of lines dedicated to a pair of users or multiple users. 


The 5494 includes support for attachment to X.25 PSDNs. Unless specifically 
stated in this book, the 5494 adheres to the following standards: 


e CCITT Recommendation X.25 “Interface Between Data Terminal Equipment 
(DTE) and Data Circuit-Terminating Equipment (DCE) for Terminals Operating 
in the Packet Mode and Connecting to Public Data Networks by Dedicated 
Circuit,” Geneva 1976 and 1980, Malga-Torremolinos 1984, Melbourne 1988 


e The X.25 Interface for Attaching SNA Nodes to Packet Switched Data 
Networks, General Information Manual 


e The X.25 1984/1988 Interface for Attaching SNA Nodes to Packet Switched 
Data Networks, General Information Manual. 


Note: In this book, all data strings are presented with the most significant byte on 
the left. Byte and bit numbers are also written from left to right beginning with byte 
0 bit 0 as the most significant bit. 


X.25 Functional Support 


The X.25 PSDN uses four communication levels to facilitate the transport of user 
data and control information between DTE. The 5494 and the AS/400 system are 
referred to as DTEs in the PSDN’s naming convention. 


The four levels of an X.25 PSDN are responsible for the following functions: 


X.25 Physical Level: The mechanical, electrical, functional, and procedural 
characteristics needed to activate, maintain, and deactivate the physical link 
between DTE and DCE. 


X.25 Link Level: The link access procedure for the interchange of data across 
the link between DTE and DCE. 


X.25 Packet Level: The packet format and control procedure for the exchange 
of packets containing control and user data between DTE and DCE. 


X.25 Logical Link Control (LLC) Level: The level that provides enhanced 
capabilities above the packet level. These capabilities include link connection 
and disconnection between DTEs, link test, operational mode selection, and 
identification exchange between DTEs. 
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X.25 Optional Facilities 


The 5494 supports the following X.25 optional facilities: 


e Throughput class negotiation 

e One-way logical channel outgoing 

¢ One-way logical channel incoming 

e Incoming calls barred 

e Outgoing calls barred 

e¢ Closed user group selection 

¢ Reverse charge acceptance 

e Extended packet sequence numbering 
e Flow control parameter negotiation 

e Nonstandard default packet sizes 

e Nonstandard default window sizes 

e Local charging prevention 

¢ Network user identifier 

e Hunt group 

¢ Call redirection 

¢ Called line address modified notification 
¢ Call redirection notification 

e Recognized private operating agency (RPOA) selection. 


As needed, the 5494 supports the following facilities: 


e Reverse charge acceptance 

Closed user group selection 

Throughput class negotiation 

Minimum transit delay selection and indication 
Calling DTE address extension 

e Called DTE address extension 

e Priority. 


X.25 Physical Level 


X.25 Link Level 
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The 5494 supports the following X.25 physical interfaces and line speeds: 


Physical Interfaces Line Speeds 

V.24/V.28 (X.21 bis) 2400 through 19200 bps 
V.35 (X.21 bis) 2400 through 128000 bps 
X.24/X.27 (X.21) 2400 through 128000 bps 


The link-level procedure used to control the state of the DTE to DCE interface is 
link access protocol-balanced (LAPB). LAPB is a subset of high-level data link 
control (HDLC) as specified by the International Organization for Standardization 
(ISO), Class BA with options 2 and 8. Figure 3-1 on page 3-3 shows the format of 
a LAPB frame. The flag and frame check sequence fields are functionally 
equivalent to the same components of an SDLC frame. See “Frame Format’ on 
page 2-5 for a description of these fields. The station address and control fields for 
X.25 are defined in the following sections. When a data packet contains an LLC 


information frame, the LLC data field contains an SNA PIU. For more information 
about the PIU, see “SNA LU 4 and LU 7 Path Information Unit” on page 13-12. 


TT Frame OO 
Starting Station Frame Check Sequence Ending 
Flag (F) | Address (A) | CONtO! (C) (FCS) Flag (F) 


101111110: ' Variable-length we CEee 
! ' field (integral 





Information (1) 





' number of 
<< 8 bits —><— 8 bits eat 8-bit bytes) + 16 bits ———_»> 


Packet 
Header (PH) | Packet Data Field 


4-24-32 bits Bx— 0-8192 bits —> 


Logical Link Control 
(LLC) LLC Data Field 


‘40-48 bits ——»<— 0.8192 bits —> 


Figure 3-1. LAPB Frame Format 


LAPB Addressing 


Because the LAPB exchange is between the 5494 and its DCE, the address field is 
used differently than in SDLC. The 5494 transmits a frame with X'01' in the 
address field if it is a command and X'03' if itis a response. The DCE transmits 
an address field of X'03' with commands and X'01' with responses. 


LAPB Commands 
At the link level, the 5494 supports three types of frames. These are: 


e Unnumbered frames 
¢ Supervisory frames 
e Information frames. 


These frame types are similar to SDLC frame types. However, they govern only 
the exchange of information between the 5494 and its DCE. End-to-end logical link 
control is handled at the LLC layer and is transparent to the LAPB commands and 
responses. The LAPB commands are encoded into the control field as they are in 
SDLC. Figure 3-2 on page 3-4 lists the supported LAPB commands and 
responses and provides the control field encoding for the LAPB frames. 
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Binary 
Configuration 





Poll/Final 
Bit 


Response 


l-field 





Frames Through 


Prohibited 
Resets Nr 
Confirms 


Format ! Acronym Definitions 


Set Asynchronous 
Balanced mode. 


Disconnected mode. This 
station is in disconnected 
state. 


Disconnect. Enter normal 
disconnect mode. 


Unnumbered Acknowledgment. 
Acknowledge U commands. 


Frame Reject. Invalid frame 
received, Nr count out of range, 
l-field too long, or I-field 
present when not allowed. 





X Receive Ready. The sender is 
ready to receive. 


X Receive Not Ready. The 
sender is not ready to receive. 


x< 


Reject. Request 
retransmission of I-frames, 
starting with frame numbered Nr. 





'U = unnumbered, S = supervisory, | = information. 


Figure 3-2. LAPB Command Summary 


Link Initialization and Reconnection 


The 5494 can be configured to initialize a link at startup, wait for an Pepereteh action, 
or wait for the network to initialize the link. 


If your configuration parameters indicate single permanent virtual circuit (PVC) or 
switched virtual circuit (SVC) Answer-Only with no manual options, the 5494 starts 
the link initialization sequence without any operator action. For other 
configurations, the operator must manually start the initialization sequence. 
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Table 3-1 shows how the 5494 starts link initialization for each of several different 
DCE polling conditions. 


Table 3-1. Link Initialization Sequence under Different DCE Polling Conditions 


Polling Condition Link Initialization Sequence 

DCE does not poll 5494 waits T1 1 seconds, then sends one or more SABMs. 2 
Upon UA response, 5494 is in link active state. 

DCE polls with 5494 sends UA response and goes to link active state. 

SABM2 

DCE polls with DM 5494 sends SABM. 2 Upon UA response, 5494 is in link active 

(final bit=0) state. 


DCE polls with DISC 5494 sends DM response, then waits T1 1 seconds. If no 
response, 5494 sends SABM. 2 Upon UA response, 5494 is in 
link active state. 


1 71 is a configurable time interval. 
2 The 5494 continues sending set asynchronous balanced mode (SABM) commands at a 
configurable time interval until the DCE responds or the configured retry value expires. 


The 5494 also starts link initialization to reconnect the link whenever the link layer 
goes down due to one of the following conditions: 


e The link is in an active state, and the 5494 receives a DISC command. 


e The link is in an active state, and the 5494 receives a disconnect mode (DM) 
response. 


¢ The link is in a disconnected state, and both of the following occur: 


— The 5494 receives a UA/F, DM/F, or SABM. 
_— The 5494 is not configured for multiple PVCs or SVCs. 


X.25 Packet Level 


The X.25 packet is carried in the information field of a LAPB I|-frame. (See 

Figure 3-1 on page 3-3.) The 5494 supports several different packet types that 
are used for establishing and clearing calls, recovering from errors, and transferring 
data to and from the AS/400 system. Supported packet sizes include 64, 128, 256, 
512, and 1024 bytes. 


At the packet level, two classes of services are defined: 
PVC: These circuits appear to the DTE as dedicated or leased lines. 


SVC: These circuits appear to the DTE as switched lines and allow the 
placement of virtual calls to other DTEs on the network. 
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Basic Structure of Packets 


| Byte 2 


Packets transferred across the DTE/DCE interface consist of at least three octets. 
An octet is a unit of information consisting of eight binary digits. These three octets 
contain a general format identifier (GFI), a logical channel identifier (LCI), and a 
packet-type identifier (PTI). Other fields are appended to packets as required. 


Note: In this book, all data strings are presented with the most significant byte on 
the left. Byte and bit numbers are also written from left to right beginning with byte 
0 bit O as the most significant bit. : 


Figure 3-3 shows the general structure of an X.25 packet. 


Bits 0 1 2 3 4 5 6 7 


General Format ID Logical Channel Group 
Number 
Q D M128 M8 


Logical Channel Number 


Packet Type Identifier 





Byte 0 






Byte 1 





Packet Data Field 





Figure 3-3. General Packet Structure 


General Format Identifier 
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Bit 0 (Q Bit) is used only when qualified logical link control (QLLC) is selected. 
This bit is set to 1 to denote a logical control packet. The Q bit is always 0 when 
other LLC protocols such as enhanced logical link control (ELLC) are used. 


Bit 1 (D Bit) indicates Delivery Confirmation Requested. IBM DTEs do not support 
delivery confirmation. This bit is always set to 0 in packets sent by the 5494. lfa 
packet is received with the D bit set, a Clear Request or Reset Request packet is 
sent with diagnostic code X'E9' (D bit setting is not valid). 


Bits 2 and 3 (M128 and M8 Bits) are used to indicate that either modulo 128 or 
modulo 8 sequence numbering is being used at the packet level. This is a 
customer setup parameter. Bit 2 is set for modulo 128 operation, and bit 3 is set 
for modulo 8 operation. Bit 2 and bit 3 are mutually exclusive. 


Logical Channels 


The 5494 can communicate over only one virtual circuit (either PVC or SVC) ata 
time. Packets received by the 5494 on any channel other than the one currently in 
use are discarded with no response. The 5494 does not support data transfer on 
channel OOO. 


Packet Type Identifier 


Table 3-2 summarizes the packet types supported by the 5494 and provides the 
PT! encoded in byte 2. 


Table 3-2. Supported Packet Types 


DCE to DTE DTE to DCE Service 
PTI Packet Type PTI Packet Type SVC PVC 
X'OB' Incoming Call X'0B' Call Request X 

X'OF' Call Connected X'OF' Call Accepted X 

X'13! Clear Indication X'13! Clear Request Xx 

X'17' DCE Clear Confirmation X'17' DTE Clear Confirmation X 

X'xx! 1 DCE Data X'xx' 1 DTE Data X xX 
X'x1! 2 Receive Ready (RR) X'x1' 2 RR X X 
X'x5! Receive Not Ready (RNR) X X 
X'1B! Reset Indication X'1B' Reset Request X xX 
X'1F! Reset Confirmation X'1F! Reset Confirmation xX X 
X'FB! Restart Indication X'FB' Restart Request xX xX 
X'FF' Restart Confirmation X' FEF! Restart Confirmation X X 
yee oc Diagnostic X'F1' Xx X 


8, bits 0 through 


See Figure 3-4 on page 3-12 and Figure 3-5 on page 3-12 for these values. | 
If modulo 128, bits 0 through 6 represent the P(R) value (the packet receive sequence number). For modulo 


2 represent the P(R) value and bits 3 through 6 are set to 0. 


The following packet types are not supported by the 5494: 


Interrupt 

Interrupt Confirmation 
Reject 

Registration Request 
Registration Confirmation. 


lf an Interrupt or Interrupt Confirmation packet is received, the 5494 responds with 
a Clear Request packet (for SVC) or a Reset Request packet (for PVC) with the 
X'AA' diagnostic code. If a Reject or Registration packet is received, the 5494 
responds with a Clear Request packet (for SVC) with the X'17' diagnostic code or 
a Reset Request packet (for PVC) with the X'1B' diagnostic code. 


Packet Data Field 


The packet data field can contain additional information such as DTE addresses, 
facility information, cause and diagnostic codes, and call user data. 


For more information on data that can be included in the different packet types, 
refer to The X.25 Interface for Attaching SNA Nodes to Packet Switched Data 
Networks, General Information Manual. 
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The following functions are done at the packet level: 


e Call establishment 
e Call clearing 

e Restart 

e Reset 

e \Information transfer. 


Call Establishment : 


- Call establishment is done through an incoming or outgoing call. Call 


establishment applies only to SVC operations. 


Incoming Call Packet: The DCE indicates an incoming call to the 5494 by 
transferring an Incoming Call packet across the DTE-to-DCE interface. 


If an Incoming Call packet is received while the 5494 is waiting for a response from 
the DCE to a Call Request packet, the incoming call is discarded. 


~ You may specify a specific logical channel when establishing a link to answer a 


Functions Reference 


call. If you specify a specific logical channel through customer setup (CSV) or in 
the link establishment request, incoming calls on other logical channels are ignored. 
If you do not specify a specific logical channel, the incoming call is received on the 
logical channel that was used for the call. 


Call Accepted Packet: The 5494 accepts an incoming call by sending a Call 
Accepted packet that specifies the logical channel indicated in the Incoming Call 
packet. .User data is not included in the Call Accepted packet. The network user 
identification (NUI) facility is the only facility that may be included in the Call 
Accepted packet. 


If the NUI facility is not included, a calling or called address length and facility field 
length of X'00' is transmitted. 


If the call is not accepted, a Clear Request packet is sent with a cause code of 
X'80' (or X'00' for CCITT diagnostic codes) and a diagnostic code indicating the 
reason for clearing. 


Call Connected Packet: The 5494 receives a Call Connected packet from the 
DCE in response to a Call Request packet. The Call Connected packet is received 
when the call is connected to the AS/400 system. 


The 5494 uses the facilities specified in the Call Connected packet. The 5494 does 
not clear the call if the Call Connected packet facilities do not match the Call 
Request packet facilities. 


If the Call Connected packet is not valid, a Clear Request packet is sent with a 
cause code of X'80' (or X'00' for CCITT diagnostic codes) and a diagnostic code 
indicating the reason for clearing. : 


Call Request Packet: The 5494 initiates a call by issuing a Call Request packet 
following an operator request. The request can include optional parameters such 
as window size, packet size, and optional user facilities. 


After the 5494 issues a Call Request packet, the circuit remains in the opening 
state for 200 seconds while waiting for a Call Connected packet from the DCE. If a 
Call Connected packet is not received in this time period, an error indication is 
passed to the higher levels and the circuit is cleared. When the circuit is cleared, a 
Clear Request packet is sent with the diagnostic code X'31' indicating that a Call 
Connected packet was not received within 200 seconds. 


Call Collision: \f an Incoming Call packet is received when the 5494 has placed 
the circuit in the opening state, the 5494 discards the Incoming Call packet and 
does not issue a Call Accepted packet. After the Incoming Call packet is 
discarded, the 5494 places the circuit in the call-collision state. 


Call Clearing 


Call clearing applies only to SVC operations. 


DTE Clear Request Packet: The 5494 issues a clear indication to the DCE by 
sending a Clear Request packet indicating the logical channel to be cleared. The 
Clear Request packet is sent with the cause code X'80' indicating DTE-originated 
Clear. If the 5494 is configured for 1980 SNA or ISO, the Clear Request packet is 
sent with the cause code X'00'. A diagnostic code is sent indicating the reason 
for clearing. 


After issuing a Clear Request packet, the 5494 remains in the clearing state for 200 
seconds while waiting for a Clear Confirmation packet from the DCE. If a Clear 
Confirmation packet is not received in this time period, the Clear Request packet is 
issued again. If a Clear Confirmation packet is not received the second time, an 
error indication is passed to the higher levels and a Restart Request packet is 
issued. 


While in the clearing state, the 5494 ignores all packets except the Clear 
Confirmation and Clear Indication packets. 


DCE Clear Indication Packet: When the Clear Indication packet is received from 
the DCE, the 5494 responds with a Clear Confirmation packet and passes the 
Cause code and diagnostic code to the higher levels. 


lf the ELLC protocol is used, all cause codes except X'80' (or X'00' for CCITT 
diagnostic codes) initiate error recovery. 


lf the QLLC protocol is used, the packet layer is reset and no further action is — 
taken. : 


DTE Clear Confirmation Packet: This packet is used to acknowledge DCE Clear 
Indication packets. 
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DTE Clear Collision: A clear collision occurs when both the 5494 and the DCE 
simultaneously issue clear packets. When a clear collision occurs, the 5494 does 
not respond to a Clear Indication packet and continues to wait for a Clear 
Confirmation packet from the DCE. The circuit returns to the ready state when the 
Clear Confirmation packet is received. 


Restart 
Restarting is used to simultaneously clear all virtual calls and reset all virtual 
circuits. | 


DTE Restart Request Packet: A Restart Request packet is transmitted by the 
5494: | 


¢ After link-level initialization if no Clear or Reset Confirmation packet is received 
following a Clear or Reset Request packet and retry 


e After frame-level resetting is done. 


After issuing a Restart Request packet, the 5494 waits for 200 seconds for a 
Restart Confirmation packet from the DCE. If a Restart Confirmation packet is not 
received in this time period, the Restart Request packet is issued again. lfa 
Restart Confirmation packet is not received the second time, an error indication is 
passed to the higher levels and the circuit is disconnected. 


The Restart Request packet is sent with the cause code X'80' (indicating 
DTE-originated clear). The diagnostic code is not used and is always set to X'00'. 
The cause code is the same as in the Clear Request packet. 


After sending a Restart Request packet, the 5494 ignores all packets except the 
Restart Confirmation and Restart Indication packets. 


DCE Restart Indication Packet: The DCE indicates a restart by sending a 
Restart Indication packet across the interface. The 5494 reports the cause code 
and diagnostic code in the Restart Indication packet to the higher levels. The 5494 
sends a Restart Confirmation packet to the DCE in response to a Restart Indication 
packet. 


lf the ELLC protocol is used, all cause codes except X'80' (or X'00' for CCITT 
diagnostic codes) initiate recovery for PVCs. 


Restart Collision: A restart collision occurs when both the 5494 and the DCE 
simultaneously issue restart packets. When a restart collision occurs, the 5494 
does not respond to a Restart Indication packet and does not wait for a Restart 
Confirmation packet in response to the issued Restart Request packet. The packet 
level enters the ready state. 


Reset | 
Resetting is used to reinitialize a PVC. Reset removes all Data packets and resets 
the packet sequence numbers to 0. 
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DTE Reset Request Packet: The 5494 uses the Reset Request packet when a 
packet-level error is detected on a PVC circuit. 


After issuing a Reset Request packet, the 5494 remains in the resetting state for 
200 seconds while waiting for a Reset Confirmation packet from the DCE. Ifa 
Reset Confirmation packet is not received in this time period, the Reset Request 
packet is issued again. If a Reset Confirmation packet is not received the second 
time, an error indication is passed to the higher levels and the circuit is returned to 
the ready state. 


The Reset Request packet is sent with the cause code X'80' (indicating 
DTE-originated clear). If the 5494 is configured for 1980 SNA or ISO, the Reset 
Request packet is sent with the cause code X'00' and a diagnostic code indicating 
the reason for resetting. 


After sending a Reset Request packet, the 5494 ignores all packets except the 
Reset Confirmation and Reset Indication packets. 


DCE Reset Indication Packet: The DCE indicates a reset to a specified logical 
channel along with cause code and diagnostic code by sending a Reset Indication 
packet across the interface. The 5494 reports the cause and diagnostic codes in 
the Reset Indication packet to the higher levels. 


If the ELLC protocol is used, all cause codes except X'80' (or X'00' for CCITT 
diagnostic codes) initiate recovery for PVCs. 


If ELLC recovery is not initiated, the circuit is terminated. If the Reset Indication 
packet was received on a SVC, the 5494 clears the call with the diagnostic code 
X'EA' (Reset Indication on Virtual Call). 


Reset Collision: A reset collision occurs when both the 5494 and the DCE 
simultaneously issue reset packets. When a reset collision occurs, the 5494 does 
not expect a Reset Confirmation packet in response to the issued Reset Request 
packet. If ELLC is not used, the circuit is returned to the ready state. 


Information Transfer 
The following packets are used during information transfer. 


Receive Ready Packet: The 5494 sends an RR packet when a data packet is 
received and no other data packets are waiting to be transmitted. The RR packet 
also resets a previous busy indication from a received RNR packet. 


Receive Not Ready Packet: The 5494 does not send a RNR packet. If the 5494 
receives a RNR packet, the 5494 recognizes that the DCE is in a not-ready state 
and does not send packets until a RR packet is received. 


Data Packet: The 5494 sends data packets when the packet-level window is open 
and the AS/400 system has not sent a RNR packet. 
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Figure 3-4 shows the format of the data packet when modulo 8 Is being used. 


Bits oO 1 2 3 4 5 6 7 





Logical Channel Group 
Number 







Byte 0 
Byte 2 P(R) | | Mm? | P(s) 3 | O- 





Figure 3-4. Data Packet Format in Modulo 8 


1 P(S) = Packet transmitted sequence number used to provide packet-level 
acknowledgment. Retransmission of acknowledged packets is not 
supported. 7 


2 P(R) = Packet receive sequence number used to provide packet-level 
acknowledgment. Retransmission of acknowledged packets is not 
supported. 


3M= More data bit (used for segmentation.) 
Figure 3-5 shows the format of the data packet when modulo 128 is being used. 


Bits 0 1 2 3 4 5 6 7 













General Format ID Logical Channel Group 
Number 










Byte 0 Q D 1 0 
Byte 4 


Figure 3-5. Data Packet Format in Modulo 128 





1 P(S)= Packet transmitted sequence number used to provide packet-level 
acknowledgment. Retransmission of acknowledged packets is not 
supported. 


2 P(R) = Packet receive sequence number used to provide packet-level 
acknowledgment. Retransmission of acknowledged packets is not 
supported. 


3M-= More data bit (used for segmentation.) 
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Logical Link Control 
The 5494 provides the following forms of LLC for use with X.25 PSDNs: 


QLLC: QLLC employs the qualified data indicator or ‘Q bit’ in data packets to 
identify when a QLLC header is present. For data packets that contain end 
user data (SNA PIUs), a QLLC header is not present and therefore the Q bit is 
off. 


ELLC: ELLC uses extended formats in data packets to provide error detection 
facilities and optional retransmission recovery procedures. 


These LLCs are contained only in data packets and provide end-to-end link-level 
support (similar to SDLC) to the SNA layer. 
The type of LLC used during a session is determined in one of the following ways: 


e The 5494 operator specifies the LLC type when entering a Call or Answer 
Request (for SVC) or an Open request (for PVC). 


e The default LLC is used when not specified in an Open, Call, or Answer 
Request. The default LLC is selected during customer setup procedures. 


Figure 3-6 lists all of the supported commands and responses for each LLC type 
and indicates which are transmitted and received by the 5494. Commands and 
responses with similar functions are listed on the same line along with their SDLC 
equivalents. For example, LSABME, QSM, and SNRWM all control link activation. 


Cmd QLLC Resp | SDLC 
TTR] 7 rR Equivalent 
Viv Viv]! 


SNRM 









LSABME 












v 
LDISC a/ 
LXID A 
LTEST f 


LUA 





LRR 






T = Packet transmitted by the 5494 
R = Valid data packets received by the 5494 


Figure 3-6. Logical Link Control Summary 


Note: For details about XID SEND and RECEIVE, see Chapter 8, “Type 2.1 Node 
Support.” For details on other commands and responses, see Chapter 2, 
“Synchronous Data Link Control Support.” 
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The X.25 Interface For Attaching SNA Nodes To Packet Switched Data Networks, 
General Information Manual contains a comprehensive discussion of usage and 
format for each LLC type. 


Operator Network Interface 


Operation of workstations attached to the 5494 is based on interactive workstation 
support and depends on the communications link. A call must be placed and a 
communications link established for workstations to operate. The AS/400 system 
or the 5494 operator can initiate the call or call clearing. 


If a communications link is not established, the 5494 operator may initiate call 
placement using link establishment. 


SVC Call Placement 
The 5494 allows the workstation operator to initiate an SVC call request. The 
operator selects destination, logical channel, and optional X.25 network facilities. 


The IBM 5494 Remote Control Unit User’s Guide provides procedures for SVC call 
placement. 


SVC Call Answering 

The operator can indicate to the 5494 how a call is to be answered by using link 
establishment. If the 5494 is configured for Single SVC Answer-Only and manual 
options are not allowed, no operator action is needed to establish the link. In this 
case, the 5494 does not check the connection password in the incoming call 
packet. The /BM 5494 Remote Control Unit User’s Guide provides procedures for 
SVC call answering. 


Opening a PVC 

The operator can indicate to the 5494 how to open a PVC by using the Open 
command in link establishment. If the 5494 is configured for Single PVC and 
manual options are not allowed, no operator action is required to establish the link. 
The first data packet received establishes the logical channel number, and default 
values determine other circuit parameters. The /BM 5494 Remote Control Unit 
User's Guide provides procedures for opening a PVC. 


Disconnecting a Circuit 

When the workstation operator chooses to disconnect a circuit, a Disconnect 
command is issued at the link level. This is valid whenever the LLC link with the 
AS/400 system is inactive. The LLC is in the mode equivalent to the SDLC Normal 
Disconnect mode. 


The /BM 5494 Remote Control Unit User’s Guide provides procedures for 
disconnecting a circuit. 
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CCITT Recommendation X.21 describes the DTE to DCE interface for attaching to 
circuit-switched X.21 Public Data Networks. This recommendation covers the 
interface states and the rules for making transitions from one state to another. The 
interface states and transition rules govern the following: 


e¢ Physical link establishment 

e Call placement 

¢ Error detection and handling at the physical link level 
e Call clearing. 


When the 5494 is connected to an X.21 Circuit-switched line, the interface states 
and transition rules supply a formal structure for establishing a circuit to the AS/400 
system. Once this circuit is established and the interface enters the data transfer 
state, the 5494 uses SDLC and SNA protocols for transmission of user data. 


When the 5494 is connected to an X.21 leased line, the interface remains in the 
data transfer state. As a result, the 5494 does not require the X.21 state transition 
rules. SDLC and SNA serve as the operative protocols during all phases of 
operation. 


When the 5494 is attached to an X.21 Public Data Network through an X.21 bis 
DCE, the 5494 does not support circuit switching and uses only SDLC and SNA for 
transmission of user data. For circuit-switching support, the X.21 bis DCE must 
provide the switching capability. 


See Chapter 19, “Communication Interfaces,” for more information on interfaces. 


See Chapter 2, “Synchronous Data Link Control Support,” for more information on 
SDLC. | 


See Chapter 13, “Systems Network Architecture Support,” for more information on 
SNA. 


Note: In this book, all data strings are presented with the most significant byte on 
the left. Byte and bit numbers are also written from left to right beginning with byte 
0 bit O as the most significant bit. 


Supported Facilities 
The 5494 supports the following X.21 facilities: 


e Abbreviated address calling 

e Charge transfer 

e Closed user group 

e Closed user group with outgoing access 

e Direct call 

e Incoming calls barred 

e Outgoing calls barred 

e Registration/cancellation of user facilities 

e Redirection of call 

e Recognized Private Operating Agency (RPOA). 
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The workstation operator can register for, cancel, or inquire about facilities online 
as described in the /BM 5494 Remote Control Unit User’s Guide. Contact your 
network supplier to determine the format of the facility registration parameters. 


Operator Network Interface 


Operation of workstations attached to the 5494 is based on interactive workstation 


- support and depends on the communications link. A call must be placed and a 


Address Call 


Direct Call 


Call Clearing 
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communications link established for workstations to operate. With X.21 switched 
networks, the 5494 supports automatic call establishment and automatic call 
clearing. The AS/400 system or the 5494 operator can initiate the call or call 
clearing. 


lf a communications link is not established, the 5494 operator can initiate call 
placement. For call establishment procedures, refer to the /BM 5494 Remote 
Control Unit User's Guide. 


Call addressing information can be configured into the 5494 for one primary and up 
to three alternate AS/400 systems. This information includes the connection 
number of the AS/400 system site. The /BM 5494 Remote Control Unit User's 
Guide describes how to configure call addressing information into the 5494 and 
how to establish communication with the AS/400 system through an address call. 


If direct call is specified in the configuration of the 5494, communication is 
established with the AS/400 system through a direct call. When the operator 
places a direct call, the connection number of the AS/400 system site is provided 
by the network from a prestored subscription. The [BM 5494 Remote Control Unit 
User’s Guide describes how to configure and establish communication with the 
AS/400 system through a direct call. 


Calls are cleared (disconnected) in one of the following ways: 


e The 5494 initiates call clearing with a DTE clear request sequence as part of 
an error or timeout recovery procedure. 


e The workstation operator clears the call when the 5494 is in the data transfer 
phase and in Normal Disconnected mode (NDM) by entering a Disconnect 
operator command. For Disconnect command procedures, refer to the /BM 
5494 Remote Control Unit User’s Guide. 


e The DCE issues a clear indication to the 5494. 


e The AS/400 system issues an SDLC Disconnect (DISC) command. The 5494 
responds with a UA and initiates a DTE clear request sequence. 


Short Hold Mode 


In short hold mode (SHM), the link between two stations is established and 
maintained only when there is data to transfer. The 5494 supports SHM but will 
not initiate an SHM session. The AS/400 system determines and controls the SHM 
operation. 


To start an SHM session, either the AS/400 system or the 5494 initiates a call to 
the network. The call then proceeds as any other X.21 call. When the interface 
reaches the ready-for-data state and the SDLC operation starts, the AS/400 system 
sends a null XID or activation XID command (see Table 8-1 on page 8-2). The 
5494 returns an XID3 response, which indicates secondary station status and 
specifies SHM compatibility. The AS/400 system then sends an activation XID 
command specifying SHM operation and the 5494 confirms with an XID3 response. 


After SHM is selected by the XID exchange, the AS/400 system sends an SDLC 
set normal response mode (SNRM) command to start the SHM session. If the 
AS/400 system does not have any frames to transmit or acknowledge at any time 
during the session, the AS/400 system can clear the connection. The 5494 does 
not initiate call clearing. The 5494 interprets a clear request received from the 
AS/400 system during a normal response mode (NRM) as an SHM line disconnect. 
The 5494 disconnects the line and maintains the SNA session in progress. Either 
the AS/400 system or the 5494 can call to reestablish the connection. For 
information about the general format of the XID command, see Chapter 8, “Type 
2.1 Node Support.” 


Short Hold Mode XID Format 


The 5494 responds to a Format 3 XID command, but does not issue the command. 
The 5494 always responds with a Format 3 XID response. See Table 8-2 on 
page 8-3. 


The AS/400 system sends the XID command to solicit an XID response from the 
5494 when a session is to be established or reconnected. 


Short Hold Mode Retries 
The 5494 can retry reconnection attempts that fail because of network events. The 
interval between retries and the number of retries are determined from setup 
parameters. If the 5494 exhausts the retry counter, it posts the reason for the last 
retry failure to the operator, logs a permanent link error, and ends the SHM 
session. 
The following events result in SHM retries: 

¢« Acall progress signal (CPS) is received. 


All 2x and 6x CPSs cause retries. Other CPSs cause retries if they were 
specified during customer setup. Receipt of CPSs that are not valid causes 
retries. 


e A recoverable timeout condition is detected by the 5494. 
e A DCE-clear-indication is received during call reconnection. 


e A parity error is detected during call reconnection. 
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Communications Codes 
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The 5494 using X.21 circuit-switched functions receives messages and exchanges 
information with the network using the International Alphabet No. 5 (IA5) 7-bit code. — 
The 5494 supports the receipt of decimal digits 0 through 9 and colon (:) as well as 
the control codes listed in Table 4-1. 


The 5494 recognizes DCE-defined CPSs such as number busy, access barred, and 
changed numbers. The 5494 also recognizes CPSs starting with shift-in (Sl) 


-characters. The 5494 discards other DCE network information received and posts 
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no operator messages. 


The 5494 supports the transmission of all |AS5 codes to accommodate the network 
registration facility usage, but it does not check message syntax. Data entered by 
the operator is translated from extended binary-coded decimal interchange code 
(EBCDIC) to IA5 characters with odd parity and sent to the network. If a keyboard 
character not included in the IA5 character set is entered, the 5494 translates that 
entry to a NUL character. 


The 5494 makes sure that the transmitted network messages are appended with a 
+ character delimiter. The delimiter is either entered by the operator or is 
automatically added. Table 4-2 lists the control codes used in messages sent to 
the network. 


Table 4-1. Control Codes Received 
Code Definition 


BEL Indicates an incoming call when preceded by a minimum of 2 SYN 
characters and the 5494 is in state 1. 


SYN A character that precedes all transmission and may be embedded within 
transmission to maintain synchronization. 


S| Shift-in. Used in Japanese network only. Follows SYN SYN and 
precedes call progress signals or DCE-provided information. 


+ An ending delimiter that indicates end of transmission (EOT). 


A field separator used to separate fields in call progress signals or 
DCE-provided information. 


/ Indicates the start of DCE-provided information. Must be preceded by 
SYN SYN and information must be followed by a +. 


Indicates the start of DCE-provided calling and called line identification. 
Must be preceded by SYN SYN and information must be followed by a +. 


Table 4-2 (Page 1 of 2). Control Codes Sent 
Code Definition 


SYN A character that precedes all transmissions and may be embedded within 
transmissions to maintain synchronization. 


NUL A character used for fill purposes. The NUL character may be inserted 
into a data stream without affecting the information content. It is used by 
the 5494 to replace any operator-entered character that does not have an 
equivalent in the IA5 alphabet. 


Indicates the start of an abbreviated address selection sequence. Must 
be preceded by SYN SYN, and the address must be followed by a +. 


Table 4-2 (Page 2 of 2). Control Codes Sent 
Code Definition 


Used to separate facility request signals within a facility request block that 
contains two or more facility request signals, or used to separate facility 
registration/cancelation signals within a facility registration/cancelation 
block that contains two or more facility registration/cancelation signals. 


/ _ Used to separate fields (request code, indicator, parameter, or address) 
within a facility registration/cancelation signal. 


- Terminating delimiter of facility request or facility registration/cancelation 
blocks. Must be followed by a +. 


+ Ending delimiter used to indicate the EOT. Used for all transmissions. 


nan If preceded by SYN SYN and ended by a +, the sequence nnn...n is an 
address selection sequence. If preceded by SYN SYN and ended by a — 
and then a +, the sequence nnn...n is a facility block. 


X.21 Network States 


The 5494 recognizes the X.21 network interface states defined in CC/TT 
Recommendation X.21: Interface between Data Terminal Equipment (DTE) and 
Data Circuit-Terminating Equipment (DCE) for Synchronous Operation on Public 
Data Networks (Geneva, 1972; as amended 1976, 1980, 1984, and 1988). 


The circuit reference conditions used to describe the 5494 operations are shown in 
Table 4-3. 


Table 4-3. Circuit Reference Conditions 


Symbol Circuit Name Conditions 
C Circuit C Control On or Off 

I Circuit | Indicate On or Off 

r Circuit R | Receive 1 or O 

t | Circuit T Transmit 1 or 0 


Initial Conditions Following Power-On 
Following the power-on sequence, the 5494 is initialized to a 
DCE-uncontrolled-not-ready state with circuits t = 0 and c = Off. The 5494 
maintains this state during initialization. The 5494 does not check the state of the 
DCE during this period. Circuits R and | can be in any condition. The 5494 then 
presents ready to the DCE (t = 1 and c = Off) and waits for a DCE-ready (r = 1, i = 
Off). 


Receive Conditions 


A BEL character preceded by 2 or more adjacent SYN characters signals an 
incoming call from the DCE. The 5494 then accepts the call (t = 1 and c = On) 
unless there is a call collision. 
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The 5494 receives X.21 network messages only in the call establishment phase. 
For an incoming call, the messages must be preceded by the following sequence of 
characters: 


Two or more SYN characters, followed by 
One or more BEL characters, followed by 
Two or more SYN characters. 


For an outgoing call, the 5494 must be in the DTE-waiting state (state 5), and the 
message must be preceded by 2 or more SYN characters. 


The 5494 recognizes the first plus (+) character in the message as the end of the 
message. 


When the 5494 unit reaches the ready-for-data state, the 5494 switches 
automatically to the SDLC operation. 


The SDLC operation is ended if an X.21 DCE-clear (16 zeros with i = Off), is 
detected. 


Transmit Conditions 


X.21 is a duplex protocol; therefore, the 5494 transmit will not be enabled unless 
receive is active. This is necessary to receive and report network response to 
call-request. When transmit is enabled, the 5494 will progress through the calling 
states: call-request, proceed-to-select, selection-signals, and DTE-waiting. 
Following proceed-to-select state 3 (r = plus (+) character and i = Off), the 5494 will 
typically transmit 2 SYN characters followed by the message characters or the 
select data and the end of message delimiter (plus [+] character). The 5494 will 
then transmit continuous ones (1s) that signal DTE-waiting state until either the 
ready-for-data state (r = 1 and i = On) or a call-clear state (r = 0 and i = Off) is 
signaled by the DCE. 


If a direct call is initiated, the 5494 bypasses the selection-signal state 4 and does 
not transmit SYN or other IA5 characters. In this case, the 5494 will immediately 
transmit continuous ones (1s) that signal DTE-waiting state. The control circuit will 
be on for 24-bit times (c = 1) before the 5494 initiates data transfer (circuit T held 
att = 1). 


Timeout Conditions 


The 5494 detects timeout conditions T1, T2, T3A, T3B, T4B, T5, and T6 as 
specified in the CCITT Recommendation X.21. Refer to the CCITT 
Recommendation X.21 for more information. 


DCE-Clear-Confirmation 


When the 5494 signals DTE-clear-request (t = 0 and c = Off), T5 timeout is set and 
is not cleared unless a DCE-clear-confirmation (r = 0 and i = Off) followed by a 
DCE-ready (r = 1 and i = Off) is received. . 
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DCE-Controlled-Not-Ready 
The 5494 handles the DCE-controlled-not-ready (CNR) state in two ways: 


e If the 5494 receives the DCE CNR during the call-control phase, it handles the 
DCE CNR as a DCE clear condition. 


e If the 5494 receives the DCE CNR during the data transfer phase, it ignores 
the DCE CNR. Normal SDLC protocol actions handle error recovery as 
necessary. 


Call Collisions 
Call collisions can occur under the following conditions: 


e A network incoming call is indicated at the same time as or immediately after 
the 5494 sends a call-request. 


e A network incoming call is indicated while the 5494 is processing an 
operator-initiated call. 


e A network incoming call is indicated while the 5494 is in SHM, and the 
workstation operator has taken an action requiring the 5494 to reconnect the 
link. 


If the DCE indicates an incoming call (r = SYN,SYN,BEL and i = Off) during or 
immediately after the 5494 has sent a call-request (t = 0 and c = On), the 5494 
takes no action. The DCE either drops the incoming call and proceeds with the 
call-request selection sequence or attempts to establish the incoming call. If the 
DCE drops the incoming call, that call is not recognized. If the DCE attempts to 
establish the incoming call, the 5494 utilizes the call-request sequence timeout to 
end its call-request. 


If the workstation operator is in the process of making a call (call sequence 
completed but call-request not yet sent to the DCE) and an incoming call is 
indicated, the 5494 posts an error to the operator and logs the error. The 5494 
then sends a clear-request to the DCE (t = 0 and c = Off). 


If the 5494 is in SHM and the workstation operator is in the process of 
reestablishing the link, the 5494 cancels the call, increments the call-collision 
counter, and responds to the incoming call. 


Call Progress Signals 
The 5494 supports all call progress signals (CPS) specified in the CCITT 
Recommendation X.21. 


If a CPS is received during an incoming call, the call is cleared and a permanent 
link error is posted and logged. 


lf a CPS is received during an operator-initiated (outgoing) call, the recovery 
depends on the CPS received: 


Group 0 CPS (0x): If the DCE takes no action within 60 seconds, a 
DTE-clear-request is issued and a permanent link error is posted and logged. 


All other CPS groups: If a DCE-clear-indication is not received within 6 
seconds, a DTE-clear-request is issued and a permanent link error is posted 
and logged. 
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See “Short Hold Mode Retries” on page 4-3 for information on the effect of CPSs 
during SHM reconnection. 


Interface State Diagrams 
Recommendation X.21 defines the transitions between interface states that are 
allowed by all telecommunications administrations. The recognized state transitions 
for each of the four phases of a data communications operation are shown by state | 
diagrams. These diagrams are available in the /BM Implementation of X.21 
Interface, General Information Manual. 
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CCITT Recommendations V.24 and V.25 bis define interface and functional 
characteristics for serial automatic calling. The 5494 implements these protocols in 
conjunction with SDLC to provide data transfer to and from the AS/400 system. 
The 5494 must attach to a V.25 bis modem to use the V.25 bis protocol. The /BM 
5494 Remote Control! Unit Planning Guide lists supported modems. The V.25 bis 
protocol uses EIA 232D (CCITT V.24/V.28) signal lines between the 5494 and the 
DCE. Chapter 19, “Communication Interfaces,” describes the signal line 
characteristics. “Interface States” on page 5-4 describes those characteristics 
unique to the V.25 bis protocol. 


Supported Facilities 
The 5494 supports the following V.25 bis-defined facilities: 


e Addressed call 

e Synchronous bit-oriented format for commands and indications 

e Call Request command with number provided (CRN) 

e Call Request command with number and identification provided (CRI) 
e Call failure indication 

e Delayed call indication 

e Call not valid indication 

e Valid call indication 

e Incoming calls on Cl (circuit 125). 


“Commands” on page 5-2 describes the supported commands and indications. 


The 5494 does not support the following optional V.25 bis-defined facilities: 


e Direct call 

e Asynchronous and character-oriented formats 

¢« Call Request command with memory address provided (CRS) 
¢ Call Request command with double dial-up required (CRD) 

e Program commands 

e List Request commands and indications 

e Disregard or Connect Incoming Call commands 

e Incoming Call Indication message. 


Operator Network Interface 


Operation of workstations attached to the 5494 is based on interactive workstation 
support and depends on the communications link. A call must be placed and a 
communications link established for workstations to operate. The AS/400 system 
or the 5494 operator can initiate the call or call clearing. 


If a communications link is not established, the 5494 operator may initiate call 


placement. For network link establishment procedures, refer to the /BM 5494 
Remote Control Unit User’s Guide. 
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Address Call 


Call Retries 


Call Clearing 


Call address information can be configured into the 5494 for one primary and up to 
three alternate AS/400 systems. This information includes the connection number 
of the AS/400 site and (if required) the connection number of the 5494 site. The 
IBM 5494 Remote Control Unit User’s Guide describes how to configure call 
addressing information into the 5494. 


The workstation operator makes each call attempt. The number of retry attempts 
and interval between retries is determined by operator actions and DCE response. 
The 5494 does not automatically attempt call retries. : 


Calls are cleared in one of the following ways: 


e The 5494 initiates a call clearing process as a result of a call establishment 
timeout or as part of an error recovery procedure. 


e The workstation operator initiates a call clearing when the 5494 is in the data 
transfer state and in Normal Disconnected mode (NDM) by entering a 
Disconnect operator command. The 5494 proceeds with a clearing sequence 
to disconnect the link. For Disconnect command procedures, refer to the /BM 
5494 Remote Control Unit User’s Guide. 


e The DCE initiates a call disconnection process while in data transfer by 
deactivating the DSR signal. 


¢« The AS/400 system initiates call clearing with the SDLC Disconnect (DISC) 
command. When a Disconnect command is received in data transfer, the 5494 
sends the appropriate SDLC unnumbered response to the AS/400 system and 
then clears the call. 


Call Information Messages 


Commands 
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The 5494 and the V.25 bis DCE exchange call information messages during the 
call establishment procedure using Unnumbered Information (UI) frames with the 
Poll bit set and a broadcast station address (X'FF'). The information field contains 
the message consisting of IA5 characters (7-bit codes plus 1 odd parity bit). The 
5494 sends commands and receives indications. 


The 5494 supports only the Call Request command. If the user enters a 5494 
connection number during the 5494 configuration, the 5494 uses the CRI command 
and includes both the called AS/400 system and the calling 5494 connection 
numbers in the call request; otherwise, the 5494 sends a CRN with the called 
number only. The 5494 translates the user data from EBCDIC to International 
Alphabet (IA5) codes with odd parity. If the 5494 finds a character that has no IA5 
equivalent, it translates that character to a NUL. 


indications 
The following indications are supported by the 5494: 


CFI - Call failure 
The DCE sends this indication with parameters indicating the cause for the 
failure as defined in Table 5-1. 


Table 5-1. Indication Parameters 


Parameter Description 

ET Engaged tone 

CB Local DCE busy 

RT Ring tone (timeout) 

AB Abend call (timeout) 

NT Answer tone not detected 

FC Forbidden call (for nationally dependent parameters) 


Note: Some DCEs define and use other parameters. Refer to the documentation for 
your DCE. 


DLC - Delayed call 
The DCE sends this indication to the 5494 after repeated unsuccessful 
attempts to place the call. The DCE includes a parameter to indicate the 
number of minutes the DTE must wait before attempting the next retry. 


INV - Call not valid 
The DCE sends this indication to the 5494 if it receives a command that is not 
valid or a command that it cannot perform. The 5494 does not process 
parameters sent with this indication. 


VAL - Valid call 
The DCE optionally sends this indication to the 5494 after processing a valid 
call request. The 5494 does not process parameters sent with this indication. 


lf the received indication is CFI, DLC, or INV, the 5494 clears the call and posts a 
call indication message. If more than one parameter is received from the DCE ina 
single indication, the 5494 posts only the last one. Indications other than those 
specified are ignored. 
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Interface States 


The 5494 uses the CCITT V.24 100-series circuit references shown in Table 5-2 to 
define the interface states supported. 


Table 5-2. CCITT V.24 100-series Signal Lines 


Label 
Tx1 
Rx 1 
RTS 
RFS 
DSR 
DTR 
RLSD 
Cl 


Circuit Description 


103 Transmitted Data 

104 Received Data 

105 Request to Send 

106 _—~Ready for Sending 

107 Data Set Ready 

108.2 Data Terminal Ready 

109 Received Line Signal Detect 
125. ~—— Calling Indicator 


Conditions 
Oor 1 

0 or 1 

On or Off 
On or Off 
On or Off 
On or Off 
On or Off 
On or Off 


1 The ANSI-EIA 232D reference labels these lines TD and RD, respectively. All other 
names, labels, and signal line characteristics are the same in both references. 


Initial Condition 


After the power-on reset (POR) sequence, the 5494 sets DT R=Off and maintains 
this condition throughout diagnostics and diskette load operations. During this time 
(approximately 40 seconds), the 5494 does not check the status of the DCE. After 
the diskette load is complete, the 5494 attempts to establish DTE-to-DCE dialog. 


Establishing DTE to DCE Dialog 


The 5494 attempts to communicate with the DCE in the following sequence: 
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1. The 5494 verifies that there is not an incoming call by monitoring the Cl line. If 
the Cl signal remains inactive for 10 seconds, the 5494 proceeds to the next 


step. 


2. The 5494 verifies that DSR=Off. If this condition does not exist, the 5494 waits 
350 milliseconds, then rechecks this condition. If the condition still does not 
exist, the 5494 posts an error code to all active workstations, and rechecks the 
line at 5-second intervals. | 


3. After verification, the 5494 sets DTR=On and waits for the DCE to set 
RFS=On. If this does not happen within 30 seconds, the 5494 posts an error 
code, sets DI R=Off, and reattempts to establish DTE-to-DCE dialog (step 1). 


4. The 5494 and the DCE reach dialog state when RFS=On. The 5494 is then 
ready to receive incoming calls or place operator-initiated outgoing calls. 


Incoming Calls 


The DCE indicates an incoming call to the 5494 by setting Cl=On. If the 5494 and 
DCE are in dialog state and the 5494 is not processing an operator-initiated 
Outgoing call, then the 5494 waits for the DCE to set the call-connected state 
(RFS=Off and DSR=On). Otherwise, the 5494 clears the call by setting DTR=Off. 
lf, after a period of time (specified at configuration), the DCE does not signal the 
call-connected state, the 5494 posts an error to all active workstations and sets 
DTR=Off, clearing the call. 


Outgoing Calls 


After receiving an operator request for an outgoing call, if the 5494 and DCE are in 
the dialog state, the 5494 sends a UI frame to the DCE containing the Call Request 
command. See “Commands” on page 5-2. If the DCE does not indicate the 
call-connected state after a period of time (specified at CSU), the 5494 clears the 
call by setting DTR=Off, and posts an error code to all active workstations, 
indicating a call-connected timeout. 


Call Collision 
The 5494 can have a call collision when: 
e The 5494 is processing an operator-initiated outgoing call but has not yet sent 


the Call Request command to the DCE, and the DCE sets Cl=On (incoming 
Call). 


e The 5494 has sent the Call Request command and the DCE signals an 
incoming call. 


In both cases, the call is cleared by setting DTR=Off and posting an error code to 
all active workstations. 


Call-Connected State 


The call-connected state occurs when the DCE sets RFS=Off and DSR=On after 
either an outgoing or incoming call operation. The DCE may set these lines in any 
order as long as both are set before the timer expires (set at CSU). 


Transmission Encoding 
The 5494 uses NRZ encoding/decoding for transmission and reception of call 
information messages during the call establishment procedure in V.25 bis. After 
reaching the call-connected state, the 5494 uses the transmission encoding method 
specified during configuration (NRZ or NRZI). 
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Chapter 6. LAN Support for Token-Ring and Ethernet 


This chapter provides information about 5494 support for attachment to either of 
two local area networks (LANs): token-ring or Ethernet. This chapter does not 
contain information about LAN communication protocols or transmission 
subsystems. For information on these, refer to the books under “Related 
Publications” on page xxv. 


Overview 


The 5494 with a 5494 Token-Ring Adapter or 5494 Ethernet Adapter allows 
programmable workstations (PWSs) attached to a LAN to communicate with an 
AS/400 system through the 5494. This is called a LAN Gateway configuration 
because the 5494 serves as a gateway between LAN-attached workstations and an 
AS/400 system. 


You can also attach the 5494 as a station on a LAN to communicate with the 
AS/400 system. This arrangement permits workstations attached to the 5494 to 
communicate with an AS/400 system through the LAN. This is called LAN AS/400 
Attachment configuration because the LAN is the connection for the 5494 to the 
AS/400 system. 


For the token-ring configuration, the 5494 supports: 


¢ Logical link control IEEE 802.2 
e Medium access control IEEE 802.5 
e Data rates of 4 and 16 Mbps 


For the Ethernet configuration, the 5494 supports: 


e Logical link control IEEE 802.2 

e Medium access control IEEE 802.3 

e IEEE 802.3 frame format 

e DIX Version 2.0 frame format 

¢ A data rate of 10 Mbps 

e Attachment using one of the following connectors: 
— 10BASE2 BNC 
— 10BASE5 15-pin D-SUB 
— 10BASE-T RJ-45 


LAN Gateway Configuration 


The 5494 with a 5494 LAN adapter supports as many as 80 workstations in a LAN 
Gateway configuration. As many as 56 of these workstations can be attached to 
the 5494 through the twinaxial ports. The remainder (or all 80 workstations) can be 
attached to a LAN. 


The 5494 serves as a “pass-through” control unit for communication between LAN 
PWSs and an AS/400 system. As the data is passed from the AS/400 system to 
the LAN, the 5494 replaces the host communication protocol (SDLC, X.21, or X.25) 
with token-ring or Ethernet protocol. For information passing from the LAN to the 
AS/400 system, the 5494 replaces the LAN protocol with the appropriate host 
communication protocol. The 5494 makes only minor BIND request and SNA 
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addressing changes. All information passed between an AS/400 system and a 
PWS in an LU-LU session remains unchanged. See Chapter 12, “Programmable 
Workstation Support,” for more information. 


A 5494 in a LAN Gateway configuration generates and sends generic alerts for 
LAN errors to the AS/400 system and it forwards alerts from LAN workstations to 
the AS/400 system. 


For information about generic alerts that are generated, see “LAN Gateway Error 
Recovery” on page 6-6. For information about alert forwarding, see “Alert 
Forwarding” on page 12-3. 


Initialization and Link Establishment 
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If a LAN adapter installed without errors and the 5494 is turned on in configuration 
mode, the adapter is initialized for gateway support. When the 5494 has been 
configured for LAN Gateway and is turned on in normal mode, it opens the LAN 
adapter and waits for a LAN PWS to initiate a connection. The actual connection 
sequence is shown in Figure 6-1 on page 6-3. 
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Figure 6-1. LAN Gateway Initialization and Link Establishment 


LAN Gateway Parameters 
When configured for a LAN Gateway, an attached PWS is considered a link station. 
When the LAN Gateway configuration is selected, certain configurable parameters 
must be set to help regulate communication between the 5494 and link stations on 
the LAN. The following sections describe these parameters. 
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5494 LAN Address 
The 5494 uses a locally administered address rather than the universally 
administered address encoded on the LAN adapter. 


e For token-ring, valid values are 0 through 9 and A through F. The first four 
character positions must contain X'4000'. The default value is 
40005494E000. 


e For Ethernet, valid values are 0 through 9 and A through F. The first four 
character positions must contain X'0200' (canonical format) or X'4000' 
(token-ring format). The default value is 02005494E000. 


Note: if the address was configured in token-ring format, it is converted to 
canonical format before being used. 


5494 Service Access Point (SAP) 

This is the LAN SAP of the 5494 that is used in the connection between the PWS 
and the 5494. Valid values are X'04' through X'FC' that are multiples of X'04'. 
The default value is X'04'. 


Response Timer (T1) 

Whenever an information transfer format (l-format) logical protocol data unit (LPDU) 
or a command LPDU with the poll bit set to B'1' is sent, the 5494 starts the 
Response timer (T1). If the 5494 Response timer expires before a response is 
received, the 5494 checks the status of the receiving link station by sending a 
supervisory command LPDU with the poll bit set to B'1'. Therefore, the 5494 
Response timer must be set to a value greater than the accumulated delays that 
the frame can incur at the sending node, in the network, and at the receiving node. 


The T1 timer is an important link station timer, especially in the split bridge 
environment. T1 is used by the link stations to detect a failure to receive a required 
acknowledgement or response. There is a T1 timer at each link station. The value 
set in the 5494 and its partner link station should usually be the same. 


The T1 timer should be set equal to or greater than the maximum round trip 
transmission delay. This delay varies with the number of bridges between the 
AS/400 system and the 5494, the queuing delay at the bridges, the buffer sizes at 
the bridges, and the transmission delay across telecommunication links if you are 
using split bridges. 


For more information, refer to /BM Multisegment LAN Design Guidelines. 
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Valid values are 1 through 20 (seconds) or *. The default value is 1. A setting of 1 
to 2 seconds is typical. Setting the Response timer higher than 2 seconds can 
cause noticeable delays in responses that must be retransmitted. 


For token-ring, when * is configured, the T1 timer value is calculated by the 5494. 
This calculation is an approximation of the delay based on the number of bridges 
between the AS/400 and the 5494. Other delay factors are either not available to 
the 5494 or may vary over time. See Table 6-1 on page 6-5 for the values that 
are calculated. Table 6-1 on page 6-5 shows the value to which the T1 timer is 
set based on the number of rings in the network: 


Table 6-1. T1 Timer Values If the * Calculation is Configured 
Number of Rings 1 2 3 4 5 6 7 
T1 Timer Value 1 1 2 2 3 3 4 


Inactivity Timer (Ti) 

Whenever the Response timer is not running, the 5494 Inactivity timer (Ti) is 
running. If this timer expires, the communications link may have been lost. If so, 
the 5494 attempts to reestablish communications. 


Valid values are 1 through 99 (seconds). The default value is 30. The Inactivity 
timer should be set to a value that is at least 10 times greater than the Response 
timer (T1) setting. 


Receiver Acknowledgment Timer (T2) 

Whenever an |-format LPDU is received, the 5494 starts a Receiver 
Acknowledgment timer (T2). This timer stops when either of the following events 
occurs: 


e An acknowledgment is sent with an outgoing frame. 
e The Maximum Out (TW) value is reached. See “Maximum Out (TW).” 


When the T2 timer expires, the 5494 must send an acknowledgment as soon as 
possible. The T2 timer must be set to a value that is less than the Response timer 
(T1) setting at the sending link station. This value for T2 ensures that the sending 
link station receives an acknowledgment before its Response timer expires. 


Valid values are 1 through 255 (milliseconds). The default value is 30. A setting of 
30 to 255 milliseconds is typical. | 


Retry Count (N2) 

The Retry Count (N2) is the maximum number of times the 5494 will check the 
status of a receiving link station after the 5494 Response timer (T1) expires. This 
count prevents continual retransmission of the same I-frame. The Retry Count 
setting should be coordinated with the Response timer setting to allow for error 
detection and recovery on the network. 


Valid values are 1 through 99 (retries). The default value is 8. A setting of 10 
retries or less is typical. 


Maximum Out (TW) 
The Maximum Out (TW) is the maximum number of I-format LPDUs the 5494 may 
send before it must stop transmitting to wait for an acknowledgment. 


This value must be at least twice the value of maximum in (N3) at the receiving 
PWS. Otherwise, network response time can be severely degraded. 


Valid values are 2 through 8 (frames). The default value is 2. A setting of 2 
frames is typical. 
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Maximum In (N3) 

The Maximum In (N3) is the maximum number of I-format LPDUs the 5494 may 
receive before it must send an acknowledgment. Because very little network 
overhead or 5494 processing is required to send or receive acknowledgment 
frames, you can send an acknowledgment for every |-format LPDU received. 


This value must not be more than half of the maximum out (TW) value at the 
sending link station. 


Valid values are 1 through 4 (frames). The default value is 1. A setting of 1 frame 
is typical. 


Error Logging and Recovery 
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When an error causes the LAN connection to be lost, the 5494 logs an error and 
attempts to reopen the LAN adapter if the link failure closed the adapter. If the 
LAN adapter fails to reopen, the 5494 continues attempting to open the adapter at 
30-second intervals. 


Note: Some LAN errors require operator intervention to reopen the LAN adapter. 
See “LAN Gateway Error Recovery.” 


IBM 5494 Remote Control Unit Maintenance Information describes all system 
reference codes (SRCs) that the 5494 issues as the result of an error. 


LAN Gateway Error Recovery 
The 5494 internally logs errors by date and time. For the following problems, the 
5494 issues generic alerts if there is an AS/400 connection: 


e For token-ring: 
Lobe Problem during Insertion 
Beaconing Problem during Insertion 
Duplicate Station Address on Ring during Insertion 
Remove Ring Station Medium Access Control (MAC) Frame Received 
Undefined Error during Insertion | 
Wire Fault on Ring 
Adapter Off Ring under Beacon Auto-Recover Process 
REMOVE ADAPTER Command Received _ 
Ring Beaconing Timeout 
e For Ethernet: 
Unable to Transmit 


Duplicate Node Address on Bus 
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LAN AS/400 Attachment Configuration 


The 5494 supports as many as 56 workstations if the Twinaxial Expansion Kit is 
used, (or 28 workstations if it is not used) in a LAN AS/400 configuration. All of 
these workstations are attached to the 5494 using twinaxial cable or any cable that 
supports 5250 data stream communication. 


The 5494 with the 5494 Ethernet Adapter allows PWSs and nonprogrammable 
workstations (NWSs) attached to the 5494 to communicate with an AS/400 system 
through an Ethernet network. 


The 5494 with the 5494 Token-Ring Adapter allows PWSs and nonprogrammable 
workstations attached to the 5494 to communicate with an AS/400 system through 
a Token-Ring network. 


Initialization and Link Establishment 


When the 5494 is configured for LAN AS/400 Attachment and is turned on in 
normal mode (not configuration mode), it opens the LAN adapter and sends a 
TEST command through the LAN to the AS/400 system to determine whether the 
system is active on the LAN. If the 5494 receives no response to the TEST 
command, the 5494 resends the command at 30-second intervals until a response 
is received. This allows an automatic start of a LAN link connection when the 
AS/400 system opens an Ethernet or token-ring connection. The actual connection 
sequence is shown in Figure 6-2 on page 6-8. 
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Figure 6-2. LAN AS/400 Attachment Initialization and Link Establishment 
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Alternate AS/400 System 


The 5494 supports preconfiguration for as many as four AS/400 systems. No 
action is required to establish a communications link through a LAN to the primary 
AS/400 system. If a LAN line is available and the AS/400 Workstation Controller is 
varied on, the 5494 automatically establishes communication with the system 
designated in your configuration parameters as the primary host. 


Without concurrent host attachment, the 5494 communicates with only one AS/400 
system at a time. You must end communication with one system and manually 
initiate communication with an alternate system. (For more information about 
network link establishment, refer to the [BM 5494 Remote Control Unit User’s 
Guide.) With concurrent host attachment, the 5494 can communicate with up to 
four AS/400 systems at a time. 


LAN AS/400 Attachment Parameters 
When the communications mode is set to Token-Ring or Ethernet AS/400 
Attachment, certain configurable parameters must be set to help regulate 
communication between the 5494 and the AS/400 system. The following sections 
describe these parameters. 


AS/400 LAN Address 

This is the LAN address of the AS/400 system. Valid values are 0 through 9 and A 
through F. For Ethernet locally administered addresses, the second character 
position must be 2, 6, A, or E. 


AS/400 SAP 
This is the LAN SAP of the AS/400 system. The SAP is used in the LAN 
connection between the 5494 and the AS/400 system. 


Valid values are X'04' through X'FC' that are multiples of X'04'. The default 
value is X'04'. 


All Other Parameters 
For all other parameters (for example, 5494 LAN Address and 5494 SAP) see “LAN 
Gateway Parameters” on page 6-3. 


Error Logging and Recovery 
When an error causes the LAN connection to be lost, the 5494 logs an error and 
attempts to reopen the LAN adapter if the link failure closed the LAN adapter. If 
the LAN adapter fails to reopen, the 5494 continues attempting to open the adapter 
at 30-second intervals. 


Note: Some LAN errors require operator intervention to reopen the LAN adapter. 
See “LAN Error Recovery” on page 6-10. 


The IBM 5494 Remote Control Unit Maintenance Information manual describes all 
SRCs that the 5494 issues as the result of an error. 
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LAN Error Recovery 
The 5494 internally logs the following errors by date and time: 


e For token-ring: 
Lobe Problem during Insertion 
Beaconing Problem during Insertion 
Duplicate Station Address on Ring during Insertion 
Remove Ring Station MAC Frame Received 
Undefined Error during Insertion 
Wire Fault on Ring 
Adapter Off Ring under Beacon Auto-Recover Process 
REMOVE ADAPTER Command Received 
Ring Beaconing Timeout 
e For Ethernet: 
Unable to Transmit 


Duplicate Node Address on Bus 


LAN Statistics and Logs 
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The 5494 maintains LAN adapter and data link control statistics and logs internally. 
You can access these statistics and logs by entering a command at the 5494 
operator panel. 


Refer to 5494 Remote Control Unit Maintenance Information for further information 
on how to access these statistics and logs. 


Statistics are maintained for each link station. These include: 


e Transmit I-frames 
e Receive l|-frames 
e Transmit errors 

e T1 expired. 


Log statistics are maintained for the 5494 attachment to the LAN. These include: 
e For token-ring: 


— Line errors 

— Internal errors 

— Burst errors 

— Address Recognized/Frame Copied errors 
— Abort delimiters 

— Retransmitted frames 

— Receive congestion 

— Frame copy errors 

— Frequency errors 

— Token errors. 


e For Ethernet: 


— Transmit errors 
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— Receive congestion errors 


LAN errors are logged in the 5494 error log. 


LAN Management 


The 5494 supports a LAN manager for management of the token-ring or Ethernet 
network. For large LANs, a LAN manager is recommended for effective 
management of the network and for full LAN status visibility. 
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| Chapter 7. Frame-Relay Support 


Frame relay is a connection-oriented interface specification designed to support 
transmission of data at relatively high speeds. Frame relay originated as an option 
service of ISDN, although it has been implemented in few public ISDN networks. 
Instead, it has become very important as a network interfacing technique 
independent of ISDN. 


Frame relay is functionally similar to X.25, in that it uses a packet-switching 
protocol where a “virtual circuit” is established through the network. Architecturally, 
however, it differs from X.25 in that frame-relay routing is based on layer 2 (the 
data link layer) compared with the layer 3 (network layer) architecture used by 
X.25. This reduces the processing overhead for the equipment used to attach to 
the frame-relay network and the frame-relay network nodes. 


Frame relay is much simpler than X.25 and can therefore offer higher throughput 
rates on the same equipment. Frame relay is an interface definition. A frame-relay 
network provides connectivity between devices that are attached to the network 
through the frame-relay interface. This interface consists of pairing a local address 
(the data link connection identifier [DLCI]) on one port with a local address on 
another port elsewhere on the network. 


Communicating devices interact with one another across the network transparently, 


through a virtual link called the permanent virtual circuit (PVC). In the support 


offered by the 5494, up to four PVCs can be configured, only one of which can be 
active at one time. 


5494 Functional Support 


Release 3.1 of the 5494 provides the following frame-relay support: 
e SNA direct as described in Request for Comments (RFC) 1490. 
— Bridged frame relay is not supported. | 
: Support for the following link management interface (LMI) options: 


— ANSI T1.617 Annex D 
— CCITT Q.933 Annex A 
— No LMI 


The first two of the above options use DLCI 0 as the virtual circuit for 
communication with the network. 


e A maximum of 64 permanent virtual circuits (DLCIs) configured on the network 
link between the 5494 and the ALS. The 5494 looks at a maximum of 64 
DLClIs exchanged between itself and the frame handler (FH), but only one of 
those DLCls may be active at one time. Any additional DLCls are ignored by 
the 5494. 


e Frame relay is a configuration option for communication with the AS/400 
system. Additionally, a LAN gateway may be used to connect devices to the 
5494. 
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Frame-Relay Physical Level 


The 5494 uses the current 5494 hardware with either a V.35 or an X.21 cable. The 
maximum line speed supported is 128 Kbps. | 


Physical Interfaces Line Speeds 
V.35 56000 through 128000 bps 
X.21 56 000 through 128000 bps 


Zero-Bit Insertion 


The 5494 communications adapter performs zero-bit insertion/deletion on 
transmitted and received frames in order to maintain the uniqueness of beginning 
and ending flags. 


Transmission Encoding 


The 5494 supports both non-return-to-zero (NRZ) and non-return-to-zero inverted 
(NRZI) encoding of transmitted and received data. NRZ/NRZI operation is set in 
user configuration. 


NRZI encoding is needed for certain DCEs to prevent extended periods of 
transitionless data due to transmission of contiguous 0 bits. NRZ is recommended 
for use on digital networks and with digital DCEs. 


Frame-Relay Link Level 
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Frame-relay frames follow the IEEE 802.2 protocol. Frames of data are routed 
through the network nodes with minimal protocol termination. A frame-relay frame 
is the same as a normal SDLC/HDLC frame except that it uses two address bytes 
and has no control fields. 


Frame Format 















Information 


6 bits > ‘t— 4 bits it 3 bits > 
Figure 7-1. Frame-Relay Frame Structure 


Table 7-1. Frame Relay Core Services Values 


Abbreviation Description 

QAO & QA1 Q.922 address field 
2 bytes 

DLCIO & DLCI1 Data Link Connection Identifier 
10 bits 

C/R Command/Response bit 

EAO & EA1 Extended address bits 


EA=1 means last extension 


CC Congestion control 
FECN - Forward Explicit Congestion Notification bit 
BECN - Backward Explicit Congestion Notification bit 
DE _ - Discard Eligibility bit 


Information Frame-Relay Header and PDU/Packet 
FCS Frame Check Sequence (CRC) 
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Frame-Relay Protocol Headers/Formats 


| 

| The following frame-relay headers and PDU/Packets are contained in the 

| information field of the frame. Pad characters (X'00') are permitted between the 

| “C” field and the “NLPID” field. This is to allow boundary alignment. However, with 
| NLPID = 08, there will be 0 pad bytes. 





<i  :d@#Frramee re 


Header and PDU/Packet 





NLPID DSAP | SSAP FID2(T2.1) PDU 


| Figure 7-2. Frame-Relay Headers and Formats 


| Table 7-2. Frame-Relay Header/Formats Values 


| Abbreviation Description 

| C Control field (1 byte) 

| 03 - Q.922 (HDLC) 

| NLPID Network Level Protocol ID (1 byte) 
| 08 - CCITT Q.931 

| | L2 Layer 2 Protocol (2 bytes) 


| 4C - ISO 802.2 - byte 1 
| 80 - Undefined - byte 2 


| L3 Layer 3 Protocol (2 bytes) 
| 70 - User specified - byte 1 
| 83 - SNA Type 2.1, LU6.2 - byte 2 


| DSAP Destination Service Access Point (1 byte) 
| SSAP Source Service Access Point (1 byte) 

| ~ CTL 802.2 Control Field (1 or 2 bytes) 

| FID2 (12.1) PDU SNA LU6.2 data 
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Frame-Relay Operation 


| 

| A frame-relay network operates as follows. An end-user device sends a frame to 

| the network. A node on the network receives the frame and examines it for format 
| and size, verifying the Frame Check Sequence (FCS). The node discards the 

| frame if the frame is not valid or has been corrupted. The node examines the DLCI 
| and refers to a routing table to determine the destination of the frame. The node 

| then changes the address field in the frame header to the correct identifier for this 

| connection on the destination link. The frame is then sent along the network along 
| the destination link to the destination end-user device. 


| It is assumed that the network delivers the frames to the remote end-user device in 
| the same sequence as they were presented to the network by the local end-user 
| device. 


| Local Management Interface 


| The local management interface (LMI) is an interface between the end-user device 
| and the frame-relay network. The LMI offers the following management functions: 


| ¢ A query command that allows the end-user device to ask the network if the 
| network is still active. This Status Inquiry is also known as the “heartbeat” or 
| “keep-alive” message. 


The keep-alive exchange is used to maintain contact between the end-user 
device and the frame handler node. It consists of an exchange of sequence 
messages. The polling interval (POLLITV) specifies the intervals at which the 
end-user device sends Status Inquiry messages to the frame handler node. 
The frame handler is expected to respond with a Status message that includes 
the correct sequence number (both Status Inquiry and Status messages include 
sequence numbers). 


| e A query command to ask the network for a list of valid DLCls. 


After the number of Status Inquiry messages specified by the full inquiry 
interval (FULLINQITV) parameter have completed, the TE (5494) requests a full 
status from the frame handler. The frame handler responds with a status 
message that includes a list of PVCs (DLCls) assigned to the physical 
connection and the status of each PVC. 


| Packet (Frame) Size 
| Maximum frame size - range 265 to 1024 bytes plus frame-relay headers 


| Fragmentation/Reassembly 
| Fragmentation/Reassembly is not supported. 


Error Recovery and Reporting 


| 

| When an error causes the frame-relay connection to be lost, the 5494 logs an error. 
| If the link failure has closed the adapter, the 5494 attempts to reopen the adapter. 

| If the adapter fails to reopen, the 5494 continues to attempt to open the adapter at 

| 30-second intervals. 
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Chapter 8. Type 2.1 Node Support 


This chapter provides information about 5494 support for the T2.1 node. The T2.1 
node allows peer-to-peer connection of distributed processors (for example, AS/400 
system and 5494) and provides the physical and session-level connectivity required 
for support of independent type 6.2 logical units (LU 6.2). 


The 5494 implements T2.1 low-entry networking (LEN) end node support as 
described in the Systems Network Architecture Advanced Peer-to-Peer Networking 
Architecture Reference. 


The 5494 supports a single independent LU used for management of NWSs 
(displays and printers). This LU supports parallel sessions and can send or receive 
BINDs. No dependent LUs are supported by the 5494. For more information on 
how the 5494 provides NWS support, see Chapter 10, “Nonprogrammable 
Workstation Support.” For more information on LU session management, see “SNA 
LU 6.2 Support” on page 13-1. 


For PWSs connected to the 5494, the LUs are contained in the PWSs, and the 
5494 simply passes all LU 6.2 LU-LU traffic through for the PWS LUs. See 
“Pass-Through Function” on page 12-1 for more information on the PWS 
pass-through function. 


The Address Space Manager (ASM) in the control point of the 5494 maintains a 
single address space of 17-bit local-form session identifiers (LFSIDs) for the single 
instance of data link control (DLC) that is supported. Because the 5494 is the 
secondary link station, the LU 6.2 frames for all sessions initiated by the 5494 or by 
a PWS attached to the 5494 contain an origin address field/destination address 
field (OAF/DAF) assignor indicator (ODAI) bit = B'1' when flowing on the link to 
the adjacent link station (ALS). The LU 6.2 frames for all sessions initiated by the 
AS/400 system contain an ODAI bit = B'0' when flowing on the link to the ALS. 


The 5494 begins assigning LFSIDs to sessions initiated by itself or by an attached 
PWS with ODAI bit = B'1', session identifier high (SIDH) = X'02', and session 
identifier low (SIDL) = X'00'. Subsequent sessions initiated by the 5494 are 
assigned the lowest available SIDH/SIDL value above X'0200'. 


The 5494 must handle LFSIDs assigned by the adjacent link station (ALS) with 
ODAI = 0 for the the following LU 6.2 sessions: 

¢ NWS session (one for each NWS) 

e PWS sessions that are initiated by the AS/400. 
The 5494 can handle a maximum of 1402 sessions with ODAI = 0. The maximum 


includes 120 NWS sessions, two 5494 Utility Program remote access function 
sessions, and 1280 PWS sessions. 


All T2.1 nodes must support an XID3 exchange. This allows node characteristics 
to be determined dynamically. 
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XID Command 


8-2 


Functions Reference 


The XID command is issued by the primary link station to solicit the identification of 
the 5494. The 5494 checks received XID commands to verify the validity of the 
l-field if present, and to ensure that the ALS and the 5494 are compatible. In 
addition, the 5494 checks for protocol errors and returns an XID negotiation error 
(X'22') control vector in the I-field of its XID response if an error condition is 
detected in the received XID command. The 5494 checks for the error conditions 
listed in Table 8-1. The byte and bit values listed in Table 8-1 are those used in ° 
the XID negotiation error control vector in Table 8-2 on page 8-3. 


Table 8-1. XID Command I-field Error Conditions 
Byte Bit Description 


256 0 XID I-field > 255 bytes 

0 0 Format of I-field = X'3' (must be Format 3 XID) 

1 0 XID I-field length = length of received frame 

1 0 XID I-field length < 29 bytes 

9 4 XID exchange state = B'00' (ESI not supported), or protocol 
(state) error 

17 O- DLC type = X'01' (must be SDLC) 

19 1 ABM support = B'0' (must not support ABM if not X.25 ELLC) 
ABM support = B'1' (must support ABM if X.25 ELLC) 

19 2 Link station role = B'00' (ALS must not be secondary), or 
protocol (role) error 

21 1 Max BTU length the XID sender can receive < X'0109' (Primary 
must support at least 265 byte BTUs) 

23 4 SDLC profile = X'0' (must support SNA link profile) — 

27 1 Max I-frames XID sender can receive before acknowledgment is 


sent = X'00' or > X'07' (X'00' is not valid and > X'07' 
requires modulo 128) 


XID Negotiation Error Control Vector 
0 Control vector present in received XID3 (byte value points to 
start of control vector received) 
Note: Reserved bits are not checked. Additional control vectors contained in the XID3 


command are ignored and do not cause an error. 


Key: X=hexadecimal B=binary == not equal. 


The XID response is transmitted by the 5494 only in response to an XID command 
from the primary link station. The XID exchange is valid in both Disconnected 
mode and Normal Response mode. 


Table 8-2 on page 8-3 defines the I-field contents sent in the XID response by the 
5494. . 


Table 8-2 (Page 1 of 3). XID Response Format | 


Bytes 


6-7 
8-9 


10 


11-16 
17 
18 
19 


20 
21-22 


23 


24 


Bits 
0-3 
4-7 
0-7 - 
0-11 
12-31 


0-15 


4-7 


9-11 
12-13 


14-15 


0-1 


2-7 | 
0-47 
0-7 
0-7 


2-3 
4-5 
6-7 
0-7 


1-15 
0-3 
4-7 
0-1 


Value 
X'3' 
X'2' 
X'xx'! 
X'073' 


X 'XXXxx ' 


X'0000' 
Bt 
B'0' 
Bit! 
B't' 
B'0000' 
Bit! 
B'000' 


B'01' 
Bit! 
B'00' 
B'00' 


B'000000' 
X'000000000000' 
X'01' 
X'0OB' 
B'0' 

B'0' 

Bit! 
B'00' 
B'00' 
B'00' 
X'00' 
B'0' 


X'0409' 
X'0' 
X'0' 
B'00' 
B'0' 


Description 

|-field format is Format 3 - variable format 
PU Type 2 

XID I|-field length; range = 60-79 

5494 block number 


5494 ID is provided during configuration of the 
5494. The default value is X'000aa', where 
aa = the 5494 station address. 


Reserved 

INIT-SELF not supported 

BIND accepted by 5494 

Will not send BIND segments 

Cannot receive BIND segments 

Reserved 

No SSCP-PU session 

Reserved 

XID exchange states: 
Negotiation proceeding 
Nonactivation 

Reserved 


Adaptive BIND pacing (send and receive) not 
supported 


Reserved 

Reserved 

DLC type = SDLC 

Length of DLC section = 11 
Reserved 

ABM not supported 

ABM supported (X.25 ELLC only) 
Station role: 5494 is secondary station 
Reserved 1 

Send/Receive capability: Half-duplex 
Reserved 


Format flag: Bits 1-15 contain maximum BTU 
length 


Max BTU length the 5494 can receive is 1033 
Reserved 

SDLC profile: SNA link profile supported 
Reserved 


Initialization mode: SIM and RIM not supported 
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Bytes 


25-26 
2/7 


28 


_ Bits 


3-7 
0-15 
0 
1-7 


0-7 


Value 
B'00000' 
X'0000' 
B'0' 
X'07' 


X'00' 


Product Set ID Control Vector 


29 
30 
31 
32 
33 
34 


35 
36 
37 
38-41 
42-44 
45-46 
47-53 


0-7 
0-7 
0-7 
0-7 
0-7 
0-3 
4-7 
0-7 
0-7 
0-7 
0-31 
0-23 
0-15 
0-42 


X'10' 
X'17' 
X'00' 
X'16' 
X'11' 
X'0! 
X'1' 
X'13' 
X'00! 
X'12' 
C'5494' 
C'00n' 
C'nn' 


C'oOnnnnn' 


Network Name Control Vector 


54 
55 
56 
57-n 


0-7 


0-7 


0-7 


X'0OE' 
X'xx' 
X'F4!' 


Cre: 6 


Negotiation Error Control Vector 2 


0 


, 
2-3 
4 

5-8 


0-7 


0-7 


0-7 


X'22!' 


X'03' 
X'XXXx!' 
X'xx'! 


X'XXXXXXXxX! 


Short Hold Mode Control Vector 5 


0 
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0-7 


0-7 


X'32! 


X'xx! 


Description 
‘Reserved 

Reserved 

Reserved 


Max I-frames 5494 can receive before 
acknowledgment is sent = 7 


Reserved 


CV key: Product set ID control vector 
CV length = 23 

Retired 

Length of product ID subvector = 22 

Key of product ID MS common subvector 
Reserved 

Product class = IBM hardware 

Hardware product ID subfield length = 19 
Hardware product ID subfield key 

Format type 

Machine type = 5494 

Model: 001 or 002 

Plant of manufacture 


Serial number 


CV key: Network name control vector 
CV length: Range = 4-18 
Network name type: Qualified CP name 


Network-qualified CP name: 3-17 bytes in 
format “network_name.cp_name’” where each 
name can be from 1-8 characters 


CV key: Specifies that an XID negotiation 
error has occurred 


CV length = 33 
Error byte offset: 0 origin 
Error bit offset: 0 origin 


Sense data 4 


CV key 
CV length 
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Bytes Bits Value Description 

2 0-7 X'00! Reserved 

3-n Dial digits of XID sender 

3 0-7 X'xx'! Number of dial digits (valid range = 4-14) 

4-n X'x...X! Dial digits packed (2 hex digits per byte); if 
number of digits is odd, low-order bit of last 
byte is X'C' 

n+1-p Connection identifier 

n+1 0-7 X'xx'! Length (valid range = 0-8) 

N+2-p X'x...x! Connection ID 

p+1-q Short Hold mode token 

p+1 0-7 X'00' Length (valid range = 0-8; 0 for XID sent by 
5494) 

p+2-q X'X....x! Short Hold mode token 


1 For Short Hold mode, bit 4 of byte 19 is a status indicator (B'0' = Short Hold mode active; 
B'1' = Short Hold mode reset); bit 5 of byte 19 is a Short Hold indicator (B'0' = XID 
sender incapable of Short Hold mode; B'1' = XID sender capable of Short Hold mode). 


2 The negotiation error control vector is appended only if a format or protocol violation is 
detected in the received XID command. 


3 If a Short Hold mode error occurs, CV length = 7 (X'07'). 
4 This sense data field is present only when a Short Hold mode error occurs. 


5 The Short Hold mode control vector is appended only when an XID3 command or 
response for Short Hold mode is issued. 


Key: X=hexadecimal Bz=binary C= EBCDIC character 
x = hex digit b = bit c = alphanumeric EBCDIC character 
a = alphabetic EBCDIC character 
n = numeric character 
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Chapter 9. SNA Subarea Network Support 


The 5494 is able to communicate with an AS/400 system through an SNA subarea 
network. If you have existing SNA subarea network attachments, you can connect 
the 5494 to your network and communicate with any AS/400 system that is also 
attached to the network. 


Description of SNA Subarea Network and Low-Entry Networking 


An SNA Subarea Network consists of the following SNA nodes, also called subarea 
nodes: 


e The Type 4 node is the Network Control Program (NCP) running in a 3720, 
3725, or 3745 Communication Controller. 


e The Type 5 node is the Virtual Telecommunications Access Method (VTAM*) 
running in a System/370* mainframe. 


In the traditional SNA subarea network, peripheral nodes (for example, Type 2.0 
nodes with their associated logical units [LUs]) are connected to the boundary 
functions of subarea nodes. These LUs rely on the services of the System 
Services Control Point (SSCP) in VTAM for session establishment, routing, and 
other services. These subarea networks typically have complex configurations and 
provide connectivity to the System/370 mainframe for a predefined set of resources. 


Low-Entry Networking (LEN), by comparison, is designed to allow the 
implementation of low-cost networks that are flexible and easy to use. It is based 
on the Type 2.1 (T2.1) node and provides a common protocol for peer-to-peer 
connectivity. In addition, the predefinition of system resources is minimal because 
characteristics and capabilities are exchanged dynamically during connection 
establishment. 


The T2.1 node support in NCP and VTAM allows LUs in different T2.1 nodes to 
establish sessions through the SNA Subarea Network. This support combines the 
advantages of large, heavy-duty networks with those of small, easy-to-use, 
low-entry networks. 


The support provided allows the 5494 and the AS/400 system to communicate with 
each other through the SNA Subarea Network. The 5494 and the AS/400 system 
attach to the subarea network through a low-entry networking boundary function 
(LEN-BF) provided by either NCP or VTAM. The 5494 can access the subarea 
through an NCP, 3174 network node, or a PS/2 computer operating as a network 
node. 


Figure 9-1 on page 9-2 and Figure 9-2 on page 9-3 show the 5494 and AS/400 
systems “A” and “B” attached to the network through LEN-BFs as T2.1 nodes. 


Without concurrent host attachment, the 5494 communicates with one target 
AS/400 system at a time; therefore, all NWSs connected to the 5494 are connected 
logically to the same AS/400 system. All errors reported by the 5494 also are 
reported to the same AS/400 system. 


With concurrent host attachment, the 5494 can communicate with up to four 
AS/400 systems at atime. All errors reported by the 5494 are reported to the 
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primary AS/400 system. In either case, the 5494 provides a T2.1 pass-through 
function for the PWSs, which allows each PWS to establish its own connection with 
any AS/400 system connected to the subarea network. 


In addition, using the host-initiated PWS session support, any AS/400 connected to 
the subarea network can initiate a session with any PWS attached to the 5494. 


The 5494 can be configured for up to four AS/400 connections. After 
communications are ended with one AS/400 system (for example, AS/400 H1), an 
alternate connection could be established with another AS/400 system (for 
example, AS/400 H2) without reconfiguring the 5494. 
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Figure 9-1. Attachment of Remote Workstations through an SNA Subarea Network 
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Figure 9-2. Token Ring or Ethernet Attachment of the 5494 to an SNA Subarea Network 
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Chapter 10. Nonprogrammable Workstation Support 


This chapter provides the functional details for nonprogrammable workstations 
(NWSs) attached to the 5494. See Chapter 13, “Systems Network Architecture 
Support,” for more information on SNA. 


AS/400 system support for the NWSs is maintained using the 5250 data stream 
commands and SNA LU 4 and LU 7 commands. These commands are 
encapsulated in LU 6.2 headers. 


Figure 10-1 shows the SNA path information units (PIUs) LU 6.2, LU 4, and LU 7 
as they appear in the SDLC frame. 


SNA Basic Link Unit 


Me SDLC Frame ————___—_—_—_—_—_—_—+| 
fe LU 6.2 Path Information Unit | 
he LU 6.2 Request/Response Unit ———>| 








































SDLC LU 6.2 LU 6.2 General Data LU 4 and LU 7 SDLC 
Link Transmission Request/Response Stream Header Path Information Link 
Header Header (TH) Header (RH) (LLID) Unit Trailer 





LU 4 and LU 7 LU 4 and LU 7 LU 4 and LU 7 | 
Transmission Request/Response Request/Response 
Header (TH) Header (RH) Unit (RU) 





Figure 10-1. SNA SDLC Path Information Unit 


LU 6.2 sessions must be established between the selected AS/400 system and the 
5494. These sessions serve as pipelines for the encapsulated data. The 5494 
implements an LU 6.2 closed application program interface (API) whose purpose is 
to support this encapsulation. No additional LU 6.2 support is provided for NWSs. 
For information about the X.25 PIU, see Figure 3-1 on page 3-3. 


The 5494 implements a single LU with parallel sessions for the support of all 
attached NWSs. One session is a controller session used for maintenance 
information, statistics, product information, and code upgrade. With concurrent host 
attachment, one controller session may be established with each AS/400 system. 

In addition, there is one session per active NWS with each AS/400 system with 
which the NWS is communicating. The BIND for the controller session is sent by 
the 5494, and the BINDs for the NWS sessions are sent by the AS/400 system. 
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Bring-up Operations 


In order for the 5494 to establish or reestablish a logical connection with the 
selected AS/400 system, three steps (collectively called bring-up operations) must 
be taken to activate the session. These steps are: 


1. Initialize session limits 
2. Activate the controller session 
3. Activate the workstation sessions. 
The 5494 connection attempts are triggered by one of the following: 


e Initial code load of the 5494 and successful physical link activation with one or 
more powered-on workstations 


e Link establishment by the workstation operator when the controller session is 
not already active 


e Power-on of a device when no connection is already active 
e Recovery following abnormal end of connection. 


For more specific information on link establishment, refer to the /BM 5494 Remote 
Control Unit User’s Guide. 


Initializing Session Limits 


Session limits are established through a function called Change Number of | 
Sessions (CNOS) that runs prior to establishing the controller session. Information 
is exchanged with the AS/400 system to establish the maximum number of 
sessions allowed for the 5494. This information exchange is based on the mode 
name configured in the 5494. 


The mode name configured in the 5494 matches a mode description on the AS/400 
system, and that mode description sets the limit on the number of sessions 
allowed. The mode name also controls certain session parameters such as 
maximum request/response unit (RU) size and pacing. 


If there is failure in the CNOS exchange, the 5494 performs retries if it is configured 
to do so. The number of retries and the delay between retries is selected during 
configuration. The reason for the CNOS failure is logged in the 5494 error log. If 
all retry attempts fail, an SRC is displayed on all active NWSs. 


After the retry count is exhausted, retries will continue at 10-minute intervals, if the 
5494 is configured for continuous retries. Continuous retries continue until 
connection is established or an unrecoverable error occurs. 


Activating the Controller Session 


10-2 


After successful CNOS negotiation, the 5494 establishes the controller session with 
the selected AS/400 system. The 5494 can then receive code upgrades from the 
selected AS/400 system and can send product information about its attached 
workstations. 


The controller session remains active to serve as a pipeline for maintenance, 
statistics, and product information. 


Functions Reference 


Activating the Workstation Sessions 


When an NWS is turned on, a notification identifying the device is sent to the 
AS/400 system on the controller session. After verifying that the device description 
is valid and the device has been brought online, the AS/400 system establishes an 
LU 6.2 session for the device. The standard LU 4 and LU 7 sessions are then 
established within the LU 6.2 session. Figure 10-1 on page 10-1 shows a 
complete frame as it appears on the AS/400 system link. 


Bring-down Operations 


When an NWS is turned off or when its LU 4 and LU 7 sessions end, the AS/400 
system ends the LU 6.2 connection to that device. 


The controller session is ended when the 5494 is taken offline at the AS/400 
system or when there are no active NWSs or PWSs. 


Error Recovery Operations 


Abnormal termination of an NWS LU 6.2 session results in an system reference 
code (SRC) being displayed at the failing workstation. The AS/400 system is 
responsible for attempting recovery of these sessions. 


If the controller session abnormally terminates, the 5494 attempts to recover the 
session. The number of retries and the delay between retries are selected during 
configuration. The reason for the session failure is logged in the 5494 error log. 


lf all retry attempts fail, an SRC is displayed on all active NWS displays. If there 
are active NWS sessions, they are immediately ended. However, all PWS sessions 
are maintained. 


Workstation Customization Support 


The workstation customization support (WSC) feature enables you to customize 
any NWS with keyboard translation tables (KTTs) and to customize ASCII printers 
attached to InfoWindow* II displays that support this feature. WSC also supports 
font and code correction download to InfoWindow II displays. The WSC support 
feature includes the following download functions: 


Keyboard Translation Table (KTT) 
A customized KTT enables you to tailor a keyboard to your specific needs. You 
can create a KTT on the AS/400 system using the AS/400 Workstation 
Customization utility. The KTT can then be downloaded to the 5494 for use on 
any NWS. 


Printer Definition Table (PDT) 
A customized PDT enables you to attach non-IBM ASCII printers to supported 
displays. You can create a PDT on the AS/400 system using the AS/400 
Workstation Customization utility. The PDT can then be downloaded to the 
5494 for use on InfoWindow II displays that support this feature. 
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InfoWindow II Display Font Table | 
You can choose the font table on the AS/400 system and download it to the 
5494 for use on these displays. No hardware change for this display is 
necessary. 7 


InfoWindow Il Code Correction Table 
You can download the code correction table to the InfoWindow II display. This 
enables support personnel to fix display code problems and distribute request 
price quotations (RPQs) for the display from the AS/400 system without the 
hardware having to change. | 


For complete information on workstation customization, refer to the Application 
System/400 Workstation Customization Functions Programmer’s Guide and 
Reference. 


Functions Reference 





Chapter 11. 5250 Shared Addressing 


This chapter provides the functional details for shared addressing between the 
5494 and the AS/400 system. 


Twinaxial Shared Addressing 


Prior to 5494 Release 3.0, displays capable of supporting multiple sessions 
required a separate twinaxial address for each session. With 5494 Release 3.0 
and AS/400 V3R1, newer displays such as the 3488 Model V can have 1—4 
display sessions using the same port and station address. Printer sessions 
continue to need their own unique address. 


Overview of Changes to Support Shared Addressing 
The 5494 Release 3.0 supports up to 120 sessions. One session is reserved for 
each port and station address (28 or 56). The remainder may be used as shared 
sessions. 


Interface Between the AS/400 System and 5494 


When a new session is activated, the 5494 notifies the AS/400 system with an 
NMVT PSID. It sets bits 0 and 1 of the port byte as follows: 


00 = base session 
01, 10, 11 = shared sessions (1—3) 


When the AS/400 system sends a command or data stream to the display, the LU 
7 header logical session identification (LSID) within the transmission header (TH) is 
set to the port and station of the display. Bits 4 and 5 of byte 1 of the 
request/response header (RH) indicate shared addressing sessions as follows: 


00 = base session 
01, 10, 11 = shared sessions (1—3) 


If the AS/400 system is at an earlier level than V3R1, it ignores the PSID requests 
for shared sessions and only the base session is activated. 


Any logged twinaxial cable errors are logged against the base port and station 
address. RTM data, if it is being collected, is stored by base port and station 
address. 


Interface Between the 5494 and the Display 

If the display is configured to use shared addressing, it requests a specific number 
of shared sessions (1—3) when it powers on. The 5494 releases earlier than 
Release 3.0 will tell the display it does not support shared addressing. The base 
session is activated and the display posts an error code on all shared session 
screens. 


5494 Release 3.0 and later releases provide full support for all shared sessions if 
its limit of 120 total sessions is not reached. If the limit is reached, the 5494 tells 
the display it cannot initiate some or all of the shared sessions requested. The ’ 
display allows switching only among sessions initiated. The base session is aways 
activated. 
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Data Stream Restrictions 
Shared addressing is available for left-to-right text presentation. Data stream 
requests to automatically reverse the screen (Start of Header order) are ignored. 


The Reverse key is not permitted. 
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Chapter 12. Programmable Workstation Support 


This chapter provides the functional details for the support of programmable 
workstations (PWSs) attached to the 5494. 


Pass-Through Function 


A PWS communicates with the AS/400 system through multiple LU 6.2 LU-LU 
sessions. The 5494 supports this communication by acting as a pass-through 
control unit. 


The PWS pass-through function tracks the status of the LU 6.2 LU-LU sessions, 
passes LU-LU data between the AS/400 system and the PWS, and performs 
session cleanup when sessions are ended abnormally. 


The number of sessions a PWS can establish is determined by the following: 
¢ Each PWS is limited to a maximum of 32 sessions. 


e The total number of PWS sessions that the 5494 supports for all PWSs 
attached to it is 1280. This is an average of 16 sessions per PWS if 80 PWSs 
are attached to the 5494. 


e Each PWS is guaranteed a minimum of 10 sessions. 


Note: The 5494 assumes there is a link-level connection for each PWS (a unique 
port and station address for PWSs attached to twinaxial ports of the 5494 anda 
unique link station connection for LAN-attached PWSs). The above session 
restrictions apply to each link-level connection between the 5494 and a PWS, 
regardless of whether the session originated in the PWS that is attached to the 
5494, or is just passing through that PWS. | 


PWS-Initiated Sessions 


When the PWS initiates a session by sending a BIND, the local form session 
identifiers (LFSIDs) assigned by the PWS to each session are unique for that PWS. 
However, because one 5494 might have multiple PWSs attached, the LFSID 
assigned by the PWS would not be unique on the link to the adjacent link station 
(ALS). The frames, therefore, cannot be passed through the 5494 with the LFSID 
assigned by the PWS. The 5494 must map the LFSIDs assigned by the PWS to 
an LFSID that is unique for that session on the link to the ALS. This mapping is 
performed for all frames flowing from the PWS. 


For frames flowing to the PWS, the LFSID is mapped from the LFSID used on the 
ALS link to the LFSID assigned to the session by the PWS. 


Unique LFSIDs for the link to the ALS are obtained from the Address Space 
Manager (ASM) in the T2.1 node Control Point. When a session is ended, the 
LFSID used by that session on the link to the ALS is freed so it can be used for 
new sessions. 
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Host-initiated Sessions 


BIND Handling 


12-2 


When the host initiates the SNA LU 6.2 session by sending the BIND request to the 
PWS through the 5494, the host is the primary logical unit (PLU) and assigns an 
LFSID to that session for use on the link between the host and the 5494, assuming 
the host is the ALS. The LFSIDs assigned by the host to each session are unique 


_ for the link between the host and the 5494. 


For the link to the PWS, the 5494 selects an LFSID with ODAI = 0 that is unique 
for all host-initiated PWS sessions for all PWSs attached to the 5494. As frames 
pass through the 5494 on these host-initiated sessions, the 5494 performs LFSID 
mapping, just as with the PWS-initiated sessions. 


PWSs may be brought up as soon as the 5494 completes its power-on sequence. 
Handling of BINDs received from a PWS varies depending on the state of the 
connection to the AS/400 system: 


e If the PWS sends a BIND to establish an LU-LU session with an AS/400 
system before the 5494 establishes the communication link to the ALS, the 
BIND is rejected by the 5494. 


e If the PWS sends a BIND to establish an LU-LU session with an AS/400 
system after the 5494 establishes the communication link to the ALS, but 
before the controller session is established with the AS/400 system, the BIND 
is held by the 5494 until the controller session is established, and then 
passed-through to the ALS. 


e lf the PWS sends a BIND to establish an LU-LU session with an AS/400 
system after the controller session is established with the AS/400 system, the 
BIND is immediately passed-through to the ALS. 


The 5494 does not support segmentation of SNA frames and, therefore, must 
ensure that sessions between a PWS and a host do not attempt to use 
segmenting. It must also ensure that the frames flowing on these sessions fit 
within the BTU size supported by the PWS and the ALS. The following 
adjustments are made to the contents of host-initiated and PWS-initiated BINDs 
and positive response BINDs (+rsp{BIND}s) as they pass through the 5494: 


¢ The whole basic information units (BIUs) required indicator (RU byte 6 bit 0) in 
rq(BIND) RUs and +rsp(BIND) RUs is set to B'1', segmentation not supported. 


e For rq(BIND) RuUs, if the maximum RU size sent by the secondary half-session 
(BIND RU byte 10) and the maximum RU size sent by the primary half-session 
(BIND RU byte 11) will not fit within the smaller of either the BTU size — 
supported by the ALS or the BTU size supported by the PWS, then the 5494 
reduces the maximum RU sizes (BIND RU bytes 10 and 11) such that the 
frames fit within the smaller BTU size. If the link to the ALS is X.25, the RU 
size is further reduced by 32 bytes so that the SNA transmission header (TH), 
the SNA frame, and X.25 packet header all fit within the smaller BTU size. 


e For rq(BIND) RUs, the adaptive session-level pacing support indicator (RU byte 
9, bit 0) is set to B'0', adaptive pacing not supported, and the pacing windows 
are limited to a maximum of 7. 


Functions Reference 


Session Tracking 


The PWS pass-through function tracks the status of the LU 6.2 sessions 
established between the PWS and the host by monitoring the flow of BIND and 
UNBIND requests and responses. The session status is tracked so that the LFSID 
used on the ALS link can be assigned and freed as required, and the 5494 can 
perform any necessary session cleanup when a session is ended abnormally. 
BIND requests for PWS sessions may originate from either the PWS or the host. 


Alert Forwarding 


The 5494 forwards PWS-issued alerts to the AS/400 system on the system 
services control point and a physical unit (SSCP-PU) session encapsulated in the 
LU 6.2 controller session. The 5494 does not modify these alerts in any way; they 
arrive at the AS/400 system in the same form as when they left the PWS. When 
the AS/400 system issues a response to an alert, the 5494 forwards this response 
to the PWS without change. 


Because of information added to encapsulate the alert on the controller session, the 
maximum RU size for an alert is: 


e 247 bytes when the link to the ALS supports 265-byte frames 
¢ 503 bytes when the link to the ALS supports 521-byte frames 
¢ 1015 bytes when the link to the ALS supports 1033-byte frames. 


The 5494 rejects PWS alerts that exceed these length restrictions. The 5494 also 


rejects network management vector transports (NMVTs) that do not contain alert 
major vectors. 
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Chapter 13. Systems Network Architecture Support 


This chapter describes Systems Network Architecture (SNA) as it relates to the 
5494. For a complete description of SNA, refer to Systems Network Architecture 
Technical Overview. 


Note: In this book, all data strings are presented with the most significant byte on 
the left. Byte and bit numbers are also written from left to right beginning with byte 
0 bit O as the most significant bit. 


SNA LU 6.2 Support 
This section describes the following specific LU 6.2 support details for the 5494: 


e Change number of session (CNOS) support 
¢ Transmission control functions 

e Presentation services 

e Session manager and resource manager 

e SNA LU 6.2 commands and responses. 


CNOS Support 


The 5494 supports a source CNOS session to set the limits for a single mode. 
Only one mode name can be configured. The limits cannot be renegotiated after 
the initial limits are set. The CNOS negotiation occurs before controller session 
activation, reactivation, or error recovery. 


Transmission Control Functions | 
The transmission control functions of the 5494 are as follows: 
e Transmission subsystem (TS) profile 7 is supported. 
e Fixed pacing (in the sending and receiving direction) is supported. 
e Cryptography is not supported. 
e Segmentation of RUs is not supported. 


The maximum RU size is between 256 and 1024, depending on the size allowed by 
the selected AS/400 system configuration. 
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Presentation Services 


The 5494 is a closed system; that is, there is no API to the LU 6.2 architecture. 
Function Management (FM) Profile 19 is supported with the following exceptions: 


e FMH12 (Security) is not supported. 
e The Ready to Receive (RTR) DFC command is not supported. 


¢ Contention winner/loser polarity is not negotiable; the BIND sender is th 
contention winner. | 


e Only the following combinations of request exception response (RQE), request 
definite response (RQD), change direction (CD), and conditional end bracket 
(CEB) are allowed: 


For requests: 


RQE1 CD -~CEB 

RQE1 =CD CEB 

RQD1 | ~CD CEB 
For responses: 

RQE CD ~CEB 

RQE1 ~CD CEB 


RQD =CD CEB 
e Alternate code set is not supported. 


For more information on the presentation services, refer to Systems Network 
Architecture Formats and SNA LU 6.2 Reference Peer Protocols. 


Session Manager and Resource Manager 


13-2 


The 5494 supports two logical units (LUs): 


e NWS LU 
e Local LU 


The first LU supports NWS communication with the AS/400 system and 
communication with the 5494 Utility Program when using the remote access 
function. The second LU supports communication with the 5494 Utility Program 
when using a PWS that is attached to the 5494. 


The NWS LU is defined by configuring the 5494 LU name and network name. The 
NWS LU supports parallel sessions with the AS/400 system. This allows one 
session for each NWS and for the controller. The controller session is bound with 
the PLU (5494) as the contention winner. The mode configured in the 5494 is used 
for the controller session and the NWS sessions. | 


When the 5494 Utility Program accesses the 5494 using the remote access 
function (that is, through the communication link used for attachment to the 
AS/400), a session is established between the 5494 and the NWS LU. There are 
no restrictions on the network name and LU name of the PWS. The 5494 Utility 
Program will always use a mode of #INTER and QPCSUPP for OS/2 and DOS 
respectively. 


A local LU exists for a session between the 5494 and the 5494 Utility Program 
when the PWS is attached to the 5494 by a twinaxial or LAN Gateway connection. 
The Local LU does not support parallel sessions. The default LU name is | 


Functions Reference 


LOCL5494. This name cannot be changed. The Local LU accepts BINDs, but 
never initiates a BIND. 


SNA LU 6.2 Path Information Unit (PIU) 


The SNA LU 6.2 PIU consists of 3 fields: the transmission header (TH) consisting 
of 5 bytes, the request/response header (RH) consisting 3 bytes, and the 
request/response unit (RU) consisting of 0 to 1024 bytes. These fields are shown 
in Figure 13-1. 


LU 6.2 LU 6.2 LU 6.2 


Transmission Request/Response Request/Response 
Header (TH) Header (RH) Unit (RU) 





Figure 13-1. SNA LU 6.2 Path Information Unit 


Transmission Header 

Table 13-1 shows the format for the transmission header (TH). Bits 0 through 5 of 
byte 0 never change for any communications involving the 5494. These values 
indicate that the format identification (FID) is FID2 and that segmenting is not 
permitted. 


Table 13-1. LU 6.2 Transmission Header Format 


Byte Bits Code Description 
0 0-3 B'0010' Format Identifier. FID-2 
4-5 B'11' Mapping field. Always 11 for 5494 (no segmenting) 
6 Origin Address Field (OAF)-Destination Address 
Field (DAF) Assignor Indicator 
B'0' OAF-DAF assigned by primary link station (as 
indicated in XID) 
B'1' OAF-DAF assigned by secondary link station (as 
indicated in XID) 
7 B'0' Normal flow indicator 
B'1' Expedited flow indicator 
1 Reserved 
2 X'nn'! DAF 
3 X'nn' OAF 
4-5 X'nnnn' Sequence Number Field 


Note: The 5494 is always the secondary link station when communicating with the AS/400 
system. Thus, for sessions between the 5494 and the AS/400 system started by the 5494, 

byte 0 is X'2F' or X'2E'. For sessions started by the AS/400 system, byte 0 is X'2D' or 

X'2C'. 


Request/Response Header 

Table 13-2 on page 13-4 and Table 13-3 on page 13-5 show the format for the 
request/response header (RH). This 3-byte field determines how the RU is 
interpreted. For more details, refer to System Network Architecture Formats, SNA 
LU 6.2 Reference Peer Protocols, and System Network Architecture Advanced 
Peer-to-Peer Networking Architecture Reference. 


Chapter 13. Systems Network Architecture Support 13-3 


13-4 


Table 13-2 (Page 1 of 2). Request Header Format 


Byte 
0 


Functions Reference 


Bits 


0 


Description 
Request/response indicator 

0 = Request 
Request/response unit category 


00 = FM data 

01 = Network control (not supported by 5494) 
10 = Data flow control 

11 = Session control (not supported by 5494) 


Reserved 
Format indicator (Fl) 
For SC and DFC RUs: 
1 = Format 1 (only valid value for 5494) 
For FMD RUs, LU-LU session: 


O = No FM header present 
1 = FM header follows 


Sense Data Included indicator 


O = Not included 
1 = Included 


Begin Chain indicator 


O = Not first in chain 
1 = First in chain 


End of Chain indicator 


O = Not last in chain 
1 = Last in chain 


Definite Response 1 (DR1) indicator 


0 = not DR1 
1 = DRI1 


Length-Checked Compression indicator 


0 = RU is not compressed (only value supported by the 
5494) 


Definite Response 2 (DR2) indicator 


0 = Not DR2 
1 = DR2 


Exception Response indicator 
If DR1 or DR2 is set on, then: 


0 = Definite-response requested 
1 = Exception-response requested 


Otherwise: | 

No response requested 
Reserved 
Request Larger Window indicator 


0 = Larger pacing window not requested (only value 
supported by the 5494) 


Table 13-2 (Page 2 of 2). 
Byte Bits 
6 


Table 13-3 (Page 1 of 2). 


Byte Bits 
0 0 
1-2 
4 
5 


Request Header Format 
Description 
Queued Response indicator 


0 = Response bypasses TC queues 
1 = Enqueue response in TC queues 


Pacing indicator 


0 = Not pacing 
1 = Pacing 


Begin Bracket indicator 


0 = Not beginning a bracket 
1 = Beginning a bracket 


End Bracket indicator 


0 = Not ending a bracket 
1 = Ending a bracket 


Change Direction indicator 


0 = Do not change direction 
1 = Change direction 


Reserved 
Code Selection indicator 

0 = Code 0 (only value supported by 5494) 
Enciphered Data indicator 

0 = RU is not enciphered (only value supported by the 5494) 
Padded Data indicator | 

0 = RU is not padded (only value supported by the 5494) 
Conditional End Bracket indicator 


O = Not conditional end bracket 
1 = Conditional end bracket 


Response Header Format 
Description 
Request/Response indicator 

1 = Response 
Request/Response unit category 


00 = FM data 

01 = Network control (not supported by the 5494) 
10 = Data flow control 

11 = Session control 


Reserved 
Format (FM) indicator 


O = No FM header 
1 = FM header follows 


Sense Data Included indicator 


0 = Not included 
1 = Included 
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Table 13-3 (Page 2 of 2). Response Header Format 


Byte Bits Description 
6 Begin Chain indicator 
1 = First in chain (only valid value for response) 
7 End Chain indicator 
1 = Last in chain (only valid value for response) 
1 0 Definite Response 1 (DR1) indicator 
0 = Not DR1 
1 = DRI 
1 Reserved 
2 Definite Response 2 (DR2) indicator 
0 = Not DR2 
1 = DR2 
3 Response Type indicator 
0 = Positive 
1 = Negative 
4 Reserved 
Reserved 


Queue Response indicator 


_0 = Response bypasses TC queues 
1 = Enqueue response in TC queues 


7 Pacing indicator 


O = Not pacing 
1 = Pacing 


2 Reserved 


SNA LU 6.2 Commands and Responses 


This section provides a summary of the SNA LU 6.2 commands and responses of 
the 5494 and describes the BIND request in detail. Table 13-4 lists the SNA LU 
6.2 commands supported by the 5494. Table 13-5 on page 13-7 shows the format 
of the LU 6.2 BIND request and response for the 5494. 


Table 13-4. SNA LU 6.2 Command Summary 


Required 
Space 
RU Code Number of Type To/From Character 
Command Point RU Bytes | Session Type Flow 5494 (RSP) Type 
BIND X'31!' Variable LU-LU Expedited To/From ~RQD 
BIS X'70' 1 LU-LU Normal To/From RQD, CD 
LU Status | | 
(LUSTAT) X'04' 5 LU-LU Normal To/From RQE1, CD 
SIGNAL X'C9' 5 LU-LU Expedited To/From RQD 
UNBIND X'32! Variable LU-LU Expedited To/From RQD 
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Table 13-5 (Page 1 of 3). LU 6.2 BIND Request and Response RU Format for the 5494 


Bytes 


0 
1 


2 


10 
11 


12 


13 


14 


Bits 


0-7 
0-3 
4-7 
0-7 
0-7 


WONONGAARWN =O 
oO 


2-7 
0-1 
2-7 


Field 


Request code 
Format 1 
Type 1 

FM profile 

TS profile 


FM Usage (primary) 
Chaining use 
Request mode 
Chain response 
Reserved 

Send end bracket 


FM Usage (secondary) 
Chaining use 

Request mode 

Chain response 
Reserved 

Send end bracket 


FM Usage (common) 
Whole BiUs required 
FM headers 

Bracket reset 

Bracket termination rule 
Code set 

Reserved 

BIND queuing indicator 
FM Transaction mode 
Recovery responsibility 
Brackets contention winner or 
loser 1 

Reserved 

Control vectors indicator 
HDX-FF reset state 


TS Usage (8-13) 

Staging indicator (secondary) 
Reserved 

Secondary send pacing count 1 
Adaptive pacing support 
Reserved 

Secondary receive pacing 
count 

Max RU size sent by 
secondary on normal flow 1 
Max RU size sent by primary 
on normal flow 1 

Staging indicator (primary) 
Reserved 

Primary send pacing count 
Reserved 

Primary receive pacing count 


PS Profile (14-25) 
PS usage format 


Value 
X'31' 
X'0' 
X'0' 
X'13' 
X'07' 


- © 


cae 


WDHOWWWWWWAWW 


B'0' 
B'Q' 


B'xxxxxx' 


B'0' 
B'0' 


B'xXxxxxx ! 


X' xx! 
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Description 


BIND command 
Format 0 

Cold (negotiable) 
FM profile 19 

TS profile 7 


Multiple RU chains allowed 
Immediate Request mode 
Definite or exception response 


Will not send EB 


Multiple RU chains allowed 
Immediate Request mode 
Definite or exception response 


Will not send EB 


No segmentation 

FM headers allowed 

Reset state is in-bracket 
Rule 1 (conditional) 

No alternate code set 

Not available 

No BIND queuing 
Half-duplex flip-flop (HDX-FF) 
Symmetric 

Primary is winner 


Control vectors included 
BIND sender reset to send state 
One-stage pacing 


2 
Not supported 


2 
1024 bytes max 
1024 bytes max 
One-stage pacing 
2 | 


2 


Basic format 
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_ Table 13-5 (Page 2 of 3). LU 6.2 BIND Request and Response RU Format for the 5494 


Bytes 


15 
16-22 
23 


24 


29 
26 


27 


28-m 


m+1 
m+2 


n+1 


(n+2)-r 
n+2 


(n+3)-r 


(r+1)-s 
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Bits 
1-7 
0-7 
0-7 
0-2 
3 
4-5 
6 

7 

0 
1-2 
3-5 
6 

7 


0-7 
0-7 


Functions Reference 


Field 

LU type 

LU 6 level 

Reserved 

Reserved 
Conversation-level security 
Reserved 

Already-verified function 
Reserved 

Reserved 

Synchronization level 
Reserved 

Parallel sessions 

CNOS generalized data stream 
(GDS) variable 

Reserved 

Cryptography options 1 


Primary LU Name 


Length 
Name 1 


User Data Fields 
Length 1 

User data key 

Mode Name Subfield 
Length 1 

Subfield name 

Mode name 1 


Network-Qualified PLU/SLU 
Network Name Subfield 
Length 

Subfield key 


PLU/SLU name 1 


User Request Correlation 
Field 
Length 


Secondary LU Name 
Length 


Name 


Control Vectors 

Fully Qualified PCID Vector 
Vector key 

Vector data length 1 

PCID 

Length of CP name 


Value 


B'0000110' 
X'02' 
X'00! 
B'000' 
B'O' 

B'00' 

B'0' 


DWWWWWD 


X'xx'! 
X'00' 
C*G::c" 


X'xx' 
X'00' 


X'Xx! | 

X'02' 
C'SNASVCMG' 
or 'cccccccc' 


X'xx' 
X'04' 
X'05' 
CCC 


X'xx! 


X'xx' 
X'00' 
Cec" 


X'60' 
X'xx' 
X'XX...XX! 
X'xx' 


Description 


LU type 6 
LU 6.2 


Not supported 


Not supported 


Confirm 


Supported 
Supported 


No cryptography 


BIND request only 
Length=1-17 

In BIND response 
network name.LU name 


Structured subfields follow 


Length=1-9 

Mode name 

Reserved mode name 
User mode name from 
configuration 


Length=3-17 
Request=PLU name 
Response=SLU name 
network name.LU name 


No unit reference code (URC) 


‘present 


BIND request only 
Length=1-17 

In BIND response 
network name.LU name 


FQPCID 

Length=12-26 

Format 5 PCID (8 bytes) 
Length=3-17 | 


Table 13-5 (Page 3 of 3). LU 6.2 BIND Request and Response RU Format for the 5494 | 
Bytes Bits Field Value Description 
Network-qualified CP name C'C.ce’ network name.CP name 
1 An UNBIND or negative response is generated if a value that is not valid is specified in this field of a received 
BIND request. 


2 For BINDs sent from the 5494, all pacing count fields are set to 0. When the 5494 receives the BIND response, it 
uses the primary send pacing count as the send pacing window, and the primary receive pacing count as the 
receive pacing window. | 


For BINDs received by the 5494, the primary receive pacing count is used as the send pacing window, and the 
secondary receive pacing count is used as the receive pacing window. 


Key: X=hexadecimal B=binary C= EBCDIC character 
x = hex digit c = alphanumeric EBCDIC character 
a = alphabetic EBCDIC character 
n = numeric character 


SNA LU 6.2 Negative Responses 


For information about LU 6.2 negative responses, refer to Systems Network 
Architecture Format and Protocol Reference Manual: Architectural Logic for LU 
Type 6.2. 
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SNA LU 4 and LU 7 Support 


This section describes the following specific LU 4 and LU 7 support details for the 
5494: 


e Network addressable units 

¢ Support characteristics 

e SNA path information unit 

e SNA commands and responses. 


Network Addressable Units 


SNA defines network addressable units (NAUs) for data communications 
applications. These NAUs are divided into three major categories: 


e System services control points (SSCPs) 
e Physical units (PUs) 
e Logical units (LUs). 


System Services Control Points 
The SSCP is a special type of NAU that resides in the AS/400 system. The SSCP 
provides the following services: 


e Assists in starting the network 

e Helps establish logical connections between other NAUs 
e Assists with recovery functions 

e Provides maintenance support 

e Provides an interface to the network operator services. 


Physical Units 

The 5494 maintains a single session between the SSCP and the PU (SS-PU) as 
long as the physical link exists between the AS/400 system and the 5494. The 
ACTIVATE PHYSICAL UNIT (ACTPU) command is not required to activate this 
session. The 5494 uses the SS-PU session to transfer maintenance data and send 
alerts to the AS/400 system. 


Logical Units 
The 5494 supports LUs of type 4 (printers) and type 7 (workstations). For a list of 
supported workstations, refer to the /BM 5494 Remote Control Unit Planning Guide. 


SNA maintains an SS-LU session for each active workstation attached to the 5494. 
The ACTIVATE LOGICAL UNIT (ACTLU) command establishes this session. The 
SSCP uses the SS-LU session to send system services (SS) messages to the 
display. The LU uses the SS-LU session to request system and test functions, and 
to send LU status information to the SSCP. The BIND command logically connects 
one LU to another LU in the AS/400 system (typically an application program). 

This command specifies the communications rules for the LU-LU session and is 
sent on the LU-LU flow. 


13-10 Functions Reference 


Transmission Control Functions 
The TS profile specifies the transmission control (TC) options to be used ina 
session. The 5494 uses a subset of TS profile 7 that: 


Supports the following session control commands: 


— ACTIVATE LOGICAL UNIT (ACTLU) 

— DEACTIVATE LOGICAL UNIT (DACTLU) 
— BIND 

— UNBIND 


Does not support the following commands: 


— START DATA TRAFFIC (SDT) 

— CLEAR 

— REQUEST RECOVERY (RQR) 

SET AND TEST SEQUENCE NUMBERS (STSN) 


Allows bidirectional pacing on normal flow 


Does not allow sequence numbers on normal flow 


Specifies maximum request/response unit (RU) sizes for function management 
data in TS usage field of BIND command 


Does not support cryptography. 


The session is in brackets after the BIND command (BIND sender is in send state). 


Presentation Services | 
The FM profile specifies the data flow control (DFC) and the function management 
data services (FMDS) options to be used in sessions. The 5494 supports the 
following parts of FM profile 7: 


¢ DFC commands: 


— SIGNAL 

LU STATUS (LUSTAT) 

CANCEL 

REQUEST SHUTDOWN (RSHUTD). 


Multiple RU chains are allowed. 


Normal Flow mode is half-duplex flip-flop (HDX-FF). 


Normal Flow mode is full-duplex for workstations with pass-through data 
streams. 


Immediate Request mode is used for workstations and printers. 
Delayed Request mode is optional for printers. 
Immediate Response mode is used. 


Chains must flow RQD, RQE, or RQN. However, the 5494 does not send 
chains RQN. 


RQD chains must include a CD bit. 
End bracket (EB) is not used. 


Chain sender is responsible for error recovery. 
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e FM headers are not allowed. 
e Data compression is not supported. 


e An alternate code set is not supported by the 5494. 


SNA LU 4 and LU 7 Path Information Unit 
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The SNA LU 4 and LU 7 PIU consists of three fields: the transmission header (TH), 
the request/response header (RH), and the request/response unit (RU). These 
fields are shown in Figure 13-2. 


LU 4 and LU 7 LU 4 and LU 7 LU 4 and LU 7 


Transmission _ Request/Response Request/Response 
Header (TH) Header (RH) Unit (RU) 





Figure 13-2. SNA LU 4 and LU 7 Path Information Unit 


Transmission Header 

Table 13-6 shows the format for the transmission header (TH). Bits O through 6 of 
byte 0 never change for any communications involving the 5494. These values 
indicate that the format identification (FID) is FID-3 and that segmenting is not 
permitted. The FID describes physical link characteristics. For a complete 
description of SNA FID characteristics, refer to Systems Network Architecture 
Format and Protocol Reference Manual: Architectural Logic. 


Table 13-6. Transmission Header Format 


Byte Bits Code Description 
0 0-3 B'0011' Format Identifier. FID-3 for 5494. 
4-5 B'11' Mapping field. Always 11 for 5494 (no 
segmenting). 
6 B'0! Reserved 
7 B'0O' Normal flow indicator 
B'1' Expedited flow indicator 
1 Local Session Identifier (see note) 
0-1 B'00' SS-PU session 
B'01' SS-LU session 
B'11' LU-LU session 
B'10' Not valid 7 
2-7 B'nnnnnn' Local station address (also known as unit address) 


Note: For the 5494, an SS-PU session has an local session identifier (LSID) of X'00'. An 
LU-LU session with an attached workstation, which has a unit address of 02, has an LSID of 
X'C2'. 


Bit 7 of byte O is set when the command is an expedited-flow command. The 
receiving station inserts expedited-flow commands ahead of all pending commands 
in its request/response queue. When this bit is cleared, the request/response is _ 
added to the end of the queue. 


Byte 1 of the TH is the LSID. Bits 0 and 1 indicate the session type for this frame. 
Bits 2 through 7 are used to address the individual LUs within the 5494. For 
SS-PU sessions, bits 2 through 7 are always cleared. 


Functions Reference 


To determine the local station address for an attached workstation, multiply the port 
number (0, 1, or 2) by 7 and add the unit address for the device (0 through 6). The 
unit address is set at each workstation either by rocker switches or by software. 
Refer to the workstation documentation to interpret the switch settings for each 
device. 


Request/Response Header 

Tables 13-7 and Table 13-8 on page 13-15 show the format for the 
request/response header (RH). The RH is a 3-byte field that defines how the RU is 
interpreted. 


Table 13-7 (Page 1 of 2). Request Header Format 


Byte Bits Description 
0 0 Request/response indicator (RRI) 
O = Request 
1-2 Request/response unit category (CAT) 


00 = Function management data (FMD) 
01 = Network control (NC) (not supported) 
10 = Data flow control (DFC) 

11 = Session control (SC) 


Reserved (always a 0) 
Format indicator (Fl) for SC and DFC Rus: 


O = Format 0 (not valid) 
1 = Format 1 : 


For FMD RUs, SS-PU and SS-LU session: 


0 = No network services (NS) header present 
1 = NS header present 


For FMD RUs, and LU-LU session: 


0 = No FM header present 
1 = FM header present (not supported) 


5 Sense data included indicator (SDI) 


O = No sense data 
1 = Sense data included 


6-7 Chain control 


00 = Middle of chain 
01 = Last of chain 
10 = First of chain 
11 = Only in chain 


1 0 Definite response 1 indicator (DR11) 
1 Reserved (always a 0) 
2 Definite response 2 indicator (DR21) 
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Table 13-7 (Page 2 of 2). Request Header Format 


Byte Bits 
3 


Functions Reference 


Description 


Exception response indicator (ERI). Used in conjunction with 
DR11 and DR2I to indicate the form of the requested response. 


DR1I DR2I ERI DEFINITION 

0 0 0 No response (RQN) 

0 0 1 Reserved 

1 0 0 Definite response (RQD 1/2) 

0 1 0 

1 1 0 

1 0 1 Exception response (RQE 1/2) 
0 1 1 

1 1 1 


Shared address session 


00 = Base 

01 = Shared Session 1 
10 = Shared Session 2 
11 = Shared Session 3 


Queued response indicator 


0 = Bypass TC queue 
1 = Use TC queue 


Pacing indicator 


0 = No pacing 
1 = Pacing 


Begin bracket indicator (BBI) (always a 0) 
End bracket indicator (EBl) (always a 0) 
Change direction indicator (CDI) 


0 = Do not change direction 
1 = Change direction 


Reserved (always 0) 
Code selection indicator (CSI) . 


0 = Code 0 
1 = Code 1 (not supported) 


Enciphered data indicator (EDI) 


0 = RU is not enciphered 
1 = RU Is enciphered (not supported) 


Padded data indicator (PDI) 


0 = RU is not padded 
1 = RU is padded (not supported) 


Reserved for LU types 4 and 7 (always a 0) 


Table 13-8. Response Header Format | 


Byte Bits 
0 0 


1-2 


4-5 


Description 
Request/response indicator (RRI) 
1 = Response 
Request/response unit category (CAT) 


00 = Function management data (FMD) 
01 = Network control (NC) (not supported) 
10 = Data flow control (DFC) 

11 = Session control (SC) 


Reserved 
Format indicator (Fl), used to indicate an SNA formatted RU: 


0 = Format 0 (not valid) 
1 = Format 1 


For FMD RUs, SS-PU and SS-LU session: 


0 = No network services (NS) header present 
1 = NS header present 


For FMD RUs, and LU-LU session: 


0 = No FM header present 
1 = FM header present (not supported) 


Sense data included indicator (SDI) 


0 = No sense data 
1 = Sense data is included in the first 4 bytes of the RU 


Chain control. Only in a chain (always 11 for a response). 


Definite response 1 indicator (DR1l). The value returned is the 
same as the value in the request header. 


Reserved (always 0) 


Definite response 2 indicator (DR2I). The value returned is the 
same as the value in the request header. 


Response type indicator (RTI) 


0 = Positive response 
1 = Negative response 


Shared address session 


00 = Base 

01 = Shared Session 1 
10 = Shared Session 2 
11 = Shared Session 3 


Queue response indicator (QRI) 


0 = Bypass TC queue 
1 = Use TC queue 


Pacing indicator (Pl) 


0 = No pacing 
1 = Pacing 
' Reserved 
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SNA LU 4 and LU 7 Commands and Responses 


This section describes the SNA LU 4 and LU 7 commands and responses unique 
to the 5494. For a complete description of SNA commands and responses, refer to 
Systems Network Architecture Technical Overview. 


13-16 Functions Reference 


Figure 13-3 summarizes the SNA commands supported by the 5494. Some 
commands are found on several of the rightmost nodes of the diagram (for 
example, CANCEL). This indicates that the request is available to both partners in 
the current session. | 
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CANCEL 

LUSTAT 


RSP - LU-LU UNFORMATTED (DAT 

RSP - CANCEL 

RSP - LU-LU UNFORMATTED (DATA STREAMS) 
RSP - CANCEL 

RSP - LUSTAT 


NMVT 
NMVT 
REQMS 
RECFMS 


RSP - REQMS 
RSP - RECFMS 
RSP - NMVT 
RSP - NMVT 


* Data stream commands can be LU 4 (SCS or IPDS) or LU 7 


> Frame sent by primary station 


<q Frame sent by secondary station 


Figure 13-3. SNA LU 4 and LU 7 Command Summary 
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ACTLU 


The AS/400 system uses the ACTIVATE LOGICAL UNIT (ACTLU) command to 
initialize the SS-LU session for each workstation attached to the 5494. Table 13-9 
shows the format of the ACTLU command. Table 13-10 shows the response sent 
by the 5494. The AS/400 system examines byte 5, bits O and 1, to determine 


whether the LU is a printer or a workstation. 


Table 13-9. The ACTLU Command RU Format 


Bytes 


0 
1 


2 


Bits 
0-7 
0-7 


0-3 
4-7 


Field 
Code 
Activation type 


FM profile 
TS profile 


Table 13-10. The ACTLU Response RU Format 


Bytes 


Bits 


0-7 
0-7 
0-3 
4-7 
0-7 


0-7 


0-1 


0-7 
0-7 


Field 


Code 

Activation type 

FM profile 

TS profile 

Control Vector key 

Max RU size on SS-LU 
normal flow by 
either half-session 

LU Capabilities 

Host allowed to send 
SS requests on 
SS-LU flow 


LU able to process 
RUs on LU-LU flow 
(including BIND) 

Reserved 

LU Capabilities 

Reserved 

Reserved 


BIND 


Value 
X'OD' 


X'01' or 


X'02' 
B'0000 ' 
B'0001 ' 


Value 


X'0D! 
X'01' 
B'0000' 
B'0001' 
X'00' 
X'84! 


B'00' 
or 
B'10' 


B'O' or 
B'1' 


B'00000' 


X'00' 


X'00' 


Description 


ACTLU command 
Cold activation or 
ERP activation 
FM profile O 

TS profile 1 


Description 


ACTLU command 

Cold activation 

Same as ACTLU request 
Same as ACTLU request 
Key = '00' 

128 bytes maximum 


Printer - SS requests not 
allowed 

Display - SS requests 
allowed 

LU available 

LU powered down, or 
unrecoverable hardware error. 


The BIND command and response specify the protocols that the primary and 
secondary LUs use when communicating with each other during an LU-LU session. 
The BIND command establishes an LU-LU session between the AS/400 system 
and the requested workstation. The AS/400 system sends a BIND request to the 
5494 on the LU-LU expedited flow. The 5494 checks the BIND request and returns 
either a positive or negative response. A negative response indicates that there is 
a BIND parameter or BIND type that is not valid, or that the LU is already in 


session. 


Table 13-11 on page 13-19 and Table 13-12 on page 13-20 show the format of 
the BIND command and response for workstations (LU 7) and printers (LU 4). 


13-18 Functions Reference 


For more information on the BIND command, refer to Systems Network Architecture 
Technical Overview. 


Table 13-11 (Page 1 of 2). BIND Command and Response RU Format for Workstations LU 7 


Bytes 


0 
1 


2 


1) 


10 


11 


Bits 


0-7 
0-3 
4-7 
0-7 
0-7 


ONOoah WN = © 


f] 
ok 


0-1 


0-7 


0-7 


Field 


Request code 

Format 

Type 

FM profile 

TS profile 

FM Usage (primary) 
Chaining use 

Request mode 

Chain response 
Reserved 
Compression 

Send end bracket (EB) 
FM Usage (secondary) 
Chaining use 

Request mode 

Chain response 
Reserved 
Compression 

Send end bracket 

FM Usage (common) 
Reserved 

FM headers 

Bracket reset 

Bracket termination rule 
Code set 

Sequence number 


- Bracket initiation stop (BIS) 


Reserved 
Normal Flow mode 


Recovery responsibility 
Brackets contention winner or 
loser 

Reserved 

HDX-FF reset state 

TS Usage (8-13) 

Staging indicator (secondary) 
Reserved 

Secondary send pacing count 
Reserved 

Secondary receive pacing 
count 

Max RU size sent by 
secondary on normal flow 2 


Max RU size sent by primary 
on normal flow 2 


Value 


X'31! 
B'0000' 
B'0000' 
X'07' 
X'07' 


DWDODNwWwWW Ww 
ooo -0 = 
- -O-— - 


200-02 
-O-- - - 


DnWNWDWDOD 


BON HHHDOD 
gcoocotcsdo 


2 


X' xx! 


Description 


BIND command 
Format 0 1 

Cold (negotiable) 1 
FM profile 7 

TS profile 7 


Multiple RU chains allowed 
Immediate Request mode 
Definite or exception response 


No compression 
Will not send EB 


Multiple RU chains allowed 
Immediate Request mode 
Definite or exception response 


No compression 
Will not send EB 


FM headers not allowed 
Reset state is in-bracket 
Rule 1 (conditional) 

No alternate code set 
Not available 

BIS not sent 


Full-duplex (for pass-through 
data stream) 

Half-duplex flip-flop (HDX-FF) 
Contention loser (primary) 
Secondary is winner 


BIND sender reset to send state 


Same as BIND request 
Same as BIND request 
Same as BIND request 
‘ 


No pacing count 1 


256, 512, or maximum 1024 
bytes in the BIND response 
depending on the value received 
in the BIND request and the LU 
6.2 RU size. 

Maximum 1024 bytes in BIND 
response 
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Table 13-11 (Page 2 of 2). BIND Command and Response RU Format for Workstations LU 7 


Bytes 
12 


13 


14 


15-23 
24 


25 


1 Negative response generated if parameter that is not valid is specified in this field 


2 Support for these parameters must also be configured at the AS/400 system. 


Bits 


Field 


Staging indicator (primary) 
Reserved 
Primary send pacing count 


Reserved 

Primary receive pacing count 
PS Profile (14-25) 

PS usage format 

LU type 

Reserved 

Reserved 

Display screen size 
Reserved 

Initial program load (IPL) 
(download) 


Value 
B'0O' 

B'x' 

B! XXxXxxx' 


B'xx' 
B'xxxxxx' 


B'0' 
B'0000111' 
X'00' 

B'0' 
B'0000010' 
B'0O00000' 
B'x' 


Descrintion 


If BIND request byte 12, bit O=0, 
then BIND response byte 12, bits 
0-7 are same as BIND request 
byte 12, bits 0-7. 

If BIND request byte 12, bit O=1, 
then BIND response byte 12, bits 
0-7 are same as BIND response 
byte 9, bits 0-7. 

Same as BIND request 

Same as BIND request 


Basic format 
LU 7 (workstation) 


1920 (24 x 80) 


BIND response 

If byte 25, bit 7=0, then no 
download. 

If byte 25, bit 7=1, then request 
download. 


of the BIND request. 


Table 13-12 (Page 1 of 3). BIND Command and Response RU Format for Printers LU 4 


Bytes 


0 
{ 


2 


oe) 


13-20 


Bits 


0-7 
0-3 
4-7 
0-7 
0-7 


Field 


Request code 

Format 

Type 

FM profile 

TS profile 

FM Usage (primary) 
Chaining use 

Request mode 

Chain response 
Reserved 
Compression 

Send end bracket 

FM Usage (secondary) 
Chaining use 

Request mode 

Chain response 
Reserved 
Compression 

Send end bracket 

FM Usage (common) 
Reserved 

FM headers 

Bracket reset 

Bracket termination rule 
Code set 


Functions Reference 


Value 


X'S: 
B'0000' 


coo eee 
ooo -0O + 
- -—  - Se ese 


nWWWW 
on Oooo 


Description 


BIND command 
Format 0 1 

Cold (negotiable) 1 
FM profile 7 

TS profile 7 


Multiple RU chains allowed 
Delayed Request mode 
Definite or exception response 


No compression 
Will not send EB 


Multiple RU chains allowed 
Immediate Request mode 
Definite or exception response 


No compression 
Will not send EB 


FM headers not allowed 
Reset state is in-bracket 
Rule 1 (conditional) 

No alternate code set 


Table 13-12 (Page 2 of 3). BIND Command and Response RU Format for Printers LU 4 


Bytes 


10 


11 


12 


13 


14 


15 


16 
17 


Bits 


0-7 


0-7 


0-1 
2-/ 


NO 


ON OO BO 


Field 


Sequence number 

Bracket initiation stop (BIS) 
Reserved 

FM Transaction mode 
Recovery responsibility 
Brackets contention winner or 
loser 

Reserved 

HDX-FF reset state 

TS Usage (8-13) 

Staging indicator (secondary) 
Reserved 

Secondary send pacing count 
Reserved 


Secondary receive pacing 
count 3 


Max RU size sent by 
secondary on normal flow 3 


Max RU size sent by primary 
on normal flow 3 


Staging indicator (primary) 
Reserved 
Primary send pacing count 


Reserved 

Primary receive pacing count 
PS Profile (14-25) 

PS usage format 

LU type 

Primary Send Direction of 
Flow (15-18) 

Print Data Stream Profile 
Base DSP 

GDS subset 

Remote Job Entry (RJE) SNA 
Character String (SCS) subset 
WP final form 

WP raw form 

Reserved 

Dual pitch printer 

Proportional ESC 

Additional Media 

Console Data Stream Profile 


- Console definition 


Value 


B'0! 
B'0' 
B'0' 
B'10' 
B'0' 
B'0' 


B'000' 
B'1' 


X 
'y! 
"XXXXXX! 
'90' 


OowWwWw 


B'000001 ' 
to 
B'000111' 


X'xx'! 


aes 


B'O' 
B'x' 
B'xxxxxx' 


B'xx' 
B' xXxxxxx' 


B'0' 
B'0000100' 


Description 


Not available 
BIS not sent 


Half-duplex flip-flop (HDX-FF) 
Contention loser (primary) 
Secondary is winner 


BIND sender reset to send state 


Same as BIND request 
Same as BIND request 
Same as BIND request 


If BIND RU byte 9=1 to 7, then 
RSP=REQ. 

lf BIND RU byte 9=0 or is 
greater than 7, then set to 7. 2 


256, 512, or maximum 1024 
bytes in the BIND response 
depending on the value received 
in the BIND request and the LU 
6.2 RU size 

Maximum 1024 bytes in BIND » 
response 


If BIND request byte 12, bit O=0, 
then BIND response byte 12, bits 
0-7 are same as BIND request 
byte 12, bits 0-7. 

lf BIND request byte 12, bit O=1, 
then BIND response byte 12, bits 
0-7 are same as BIND response 
byte 9, bits 0-7. 

Same as BIND request 

Same as BIND request 


Basic format 
LU 4 (printer) 


Supported 
Supported 
Not supported 


Not supported 
Not supported 


Not supported 
Not supported 
No additional media 


No console support 
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Table 13-12 (Page 3 of 3). BIND Command and Response RU Format for Printers LU 4 


Bytes Bits 

4-7 
18 

0 

1-7 
19 0-7 
20 0-7 
21 0-7 
22 0-7 
23 

0-3 

4-5 

6-7 
24 

0-1 

2 

3 

4 

5 

6-7 
25 

0 

1 

2-6 

7 


13-22. 


Field Value Description 
Reserved X'0' 
FM and FMH Usage 
SS FM data B'0' Not supported 
FM header bits B'0000000' No FM headers 
Secondary Send Direction of 
Flow (19-22) | 
Print data stream profile X'00' No send capability 
Additional media X'00' No send capability 
Console data stream profile X'00' No send capability 
FM and FMH usage X'00' No send capability 
Code Selection 
Repertoire B'1000' EBCDIC 
Main code B'00' EBCDIC 
Reserved B'00' 
General Characteristics 
Reserved B'00' 
Data direction B'0' BIND sender may send first 
Reserved B'0' 
Attended mode B'0' BIND receiver will initiate 
| attended mode 
Alternate mode B'0O' BIND receiver will not alternate 
attended and unattended modes 
Reserved B'00' 
NCI Characteristics 
Image data *B'0' Not supported 
Speech data B'0' Not supported 
Reserved B'00000' 
IPL (Download) B'x' If byte 25, bit 7=0, then no 


download. If byte 25, bit 7=1, 
then request download. 


Negative response generated if parameter that is not valid is specified in this field of the BIND request 


5494 allows a maximum pacing count of 7 for up to three printers. Any additional printers are allowed a maximum 
pacing count of 3. A count greater than 3 causes an X'03' to be returned in BIND response byte 9. 


Support for these parameters must also be configured at the AS/400 system. 


CANCEL 
The CANCEL command stops a partially transmitted chain of FMD commands. 
The CANCEL command is sent only when a chain is in progress. The 5494 sends 


-a CANCEL on the normal LU-LU flow when it receives a negative response to a 


command in the current chain. The request code (RU byte 0) for CANCEL is 
X'83'! 


DACTLU | 

The DEACTIVATE LOGICAL UNIT (DACTLU) command ends an SS-LU session. | 
DACTLU is sent on the expedited SS-LU flow. The 5494 sends a positive 
response when the deactivation is complete. The request code (RU byte 0) for 
DACTLU is X'0OE'. 


Functions Reference 


LUSTAT 


‘The LU STATUS (LUSTAT) reports error conditions during an LU-LU or SS-LU 
session to the AS/400 system. The request code (RU byte 0) for LUSTAT is 
X'04'. The 5494 sets the CD bit when it sends LUSTAT on an LU-LU session. 
Bytes 1 through 4 of the RU for an LUSTAT command contain the status 
information, which is summarized in Table 13-13. 


Table 13-13. LUSTAT Status Field (RU Bytes 1-4) 


Status 

00000103 
00000287 
00000288 


00004040 
to 
OOOOFFFF 


00010000 


00020000 
08310000 


Session Type 
LU-LU 
LU-LU 
LU-LU 
LU-LU 


SS-LU 


SS-LU 


SS-LU or LU-LU 
SS-LU 


LU-LU 
SS-LU 


NMVT 


Description 

Display data stream parameter error (format table resequencing error) 
Display data stream parameter error (self-check field > 33 bytes) 
Display data stream parameter error (self-check FCW not valid) 


Ideographic request 


Sent when: 


Station is turned on but only if ACTLU was received while station was 
turned off 


Station becomes available after permanent hardware error (LUSTAT 
08310000 condition resolved) 


Display contention error is resolved (-RSP 082D0100 condition resolved) 


Display becomes available after IPL completion (only if a BIND was 
rejected) 


Sent after printer receives request with CD bit set 


Sent when display is powered off or has unrecoverable hardware error 
while in session (RSHUTD also sent) 


The 5494 uses the Network Management Vector Transport (NMVT) as follows: 


¢ The 5494 receives an NMVT request from the AS/400 system for product 
information about the 5494 and attached devices. The Network Services Major 
Vector (NSMV) Query Product Set ID (QPSID) is used. 


¢ The 5494 sends an NMVT to the AS/400 system with product information about 
the 5494 and attached workstations. The NSMV Product Set ID (PSID) is 


used. 


e« The 5494 sends generic alerts to the AS/400 system. 


e The SNA Response Time Monitor (RTM) function enables the 5494 to measure 
and analyze response times for NWSs, after which the AS/400 user can display 
the results of the 5494 analysis. 


When an error causes the LAN link in a LAN Gateway configuration to go down, 

the 5494 logs the error by time and date and issues a generic LAN alert. The LAN 
alerts are described in “LAN Gateway Error Recovery” on page 6-6. You can also 
find a complete description of the SNA alert format in “5494 SNA Alert Support” on 


page 14-1. 
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The 5494 also forwards alerts issued by PWSs to the AS/400 system on the 
SSCP-PU flow encapsulated in the LU 6.2 controller session. This is described in 
“Alert Forwarding” on page 12-3. 


The NMVT RU format as sent by the 5494 is summarized in Table 13-14. 


Table 13-14. NMVT RU Format 


Bytes 


0-2 
3-4 
5-6 


7 


Bits 


4-7 


Field Value Description 
Network services header X'41038D ' NMVT 
Reserved X'0000 ' 
Reserved B'0000' 
Procedure-related ID X' Xxx! 
Solicitation indicator B'0' Unsolicited 
B'1' Solicited 
Sequence field B'00' Only reply 
B'01' Last 
B'10' First 
B'11' Middle 
SNA address list B'0' Not included 
B'1' Included 
Reserved B'0' 
Network Services major vector QPSID, PSID, RTM, or generic 
alert. 


See Systems Network 

Architecture Format and Protocol 
Reference Manual: Architectural 
Logic for details of major vectors. 


REQTEST | | 

The REQUEST TEST (REQTEST) command is used to request that a test 
procedure be loaded and run. The format of the REQTEST RU as sent by the 
5494 is summarized in Table 13-15. The operator initiates a REQTEST by 
pressing the Test Request key sequence. The /BM 5494 Remote Control Unit 
User's Guide defines the Test Request key sequence for all supported keyboards. 


Table 13-15. REQTEST RU Format 


Bytes 


0-2 
0 


1 


ON DOF W ND 


13-24 


Bits 


0-1 
2-/ 
0 

1 

2-/ 
0-7 
0-7 
0-7 
0-7 
0-7 
0-7 
0-7 


Field Value Description 
Network Services Header : 
Involves PU or LU B'00' Either PU or LU 
Header type | B'000001 ' Network Services header 
Domain B'0' Same domain 

_ Reserved | B'0O' 
NS category B'000011' Maintenance Services 
Request code X'80'! REQTEST command 
Network name 1 X'00' No name present 
Network name 2 X'00' No name present 
Procedure name X'00' No name present 
Requester ID X'00' No ID present 
Password X'00' No password present 
User Field X'00' No user data present 


Functions Reference 


RECFMS 


The 5494 sends the RECORD FORMATTED MAINTENANCE STATISTICS 
(RECFMS) command when it receives a REQMS from the AS/400 system or when 
one of the statistical counters overflows. Byte 7, bit 0, indicates the reason for the 
RECFMS. Table 13-16 shows the format for the first 13 bytes of the RECFMS 


command. 


Table 13-16. RECFMS Format (Bytes 1-13) 


Bytes Bits 
0-2 
0 0-1 

2-7 
1 0 

1 

2-7 
2 
3-6 
7 0 

1 

2-7 
8-11 0-11 

: 12-31 

12-13 0-15 


Field 


Network Services Header 
Involves PU or LU 

Header type 

Domain 

Reserved 

NS category 

Request code 
Communication Network 
Management (CNM) header 


Solicitation Indicator 


Not last request 
Indicator 
Type code 


Node identification 
Block number 

ID Number 
Reserved 


Table 13-17. RECFMS Type 1 Format (Bytes 14-17) 


Bytes Bits 
14-15 0-15 
16 0-7 
17 0-7 


Field 


Test frames received 


Reserved 


Test frames received without 


error 


Value 


B'01' 
B'000001 ' 
B'0' 
B'0' 
B'000011' 
X'84' 
X' XXXXXXXX! 


X'00000000 ' 
B'1' or 
B'Q! 

B'0' 


B'000001' or 
B'000100' 


X'073' 
X'OOOxx' 
X'0000' 


Value 


X'Xxxx' 


X'00' 
X'xx'! 


Description 


PU only 
Network Services header 
Same domain 


Maintenance Services 

RECFMS command 

Solicited RECFMS (echoed from 
bytes 3-6 of REQMS) 
Unsolicited 

Reply request (REQMS) or 
Unsolicited 

Last request 


Type code of 1 or 
Type code of 4 


5494 block number 
xx = Station address 


Table 13-17 shows the format of bytes 14 through 17 of the RECFMS command 
type 2. 


Description 


Sum of communications counters 
0060 and 0061 


Communications counter 0061 
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The format of a RECFMS type 4 contains X'FF' in byte 14. The contents of the 
statistical counters and the error log begin at byte 15 of the RECFMS type 4 
response. Table 13-18 provides the format of the counters when sent. The 5494 
returns only those counters with nonzero content. The error log entries begin 
immediately following the last statistical counter sent in the RECFMS. Table 13-19 
shows the format of each entry in the log. The 5494 clears the error log after 
sending an RECFMS regardless of the Reset Indicator bit received in the REQMS 
command. 7 | 


Table 13-18. RECFMS Counter Format 


Counter Length LSID SRC Sense Data 

60 X'05' X'00' X'0060' 1 byte counter 

61 X'05' X'00' X'0061 ' 1 byte counter 

62 X'05! X'00'  X'0062' 1 byte counter 

63 X'05' X'00' X'0063' 1 byte counter 

64 X'05' X'00' X'0064' 1 byte counter 

65 X'05! X'00' X'0065' 1 byte counter 

66 X'05! X'00' X'0O066' 1 byte counter 

67 X'05! X'00' X'0067' 1 byte counter 

68 X'05'! X'00' X'0068' ~ 1 byte counter 

69 X'05' X'00' X'0069' 1 byte counter 

6A X'05' X'00' = X'006A' 1 byte counter 

6B Not Used 

6C. X'05! X'00' X'O06C' 1 byte counter 

6D X'05' X'00' X'006D' 1 byte counter 

6E X'09'! X'00' X'O0O6E' X'00' + 4 byte counter 
6F X'09' X'00' X'O0O6F' X'00' + 4 byte counter 


Table 13-19. Error Log Entry Format 
Byte Description 


Number of bytes in entry 

Logical Session ID 

SRC 

Sense Byte 0 (if present) or third byte for 3-byte SRCs 1 
Sense Byte 1 (if present) 

Sense Byte 2 (if present) 

Sense Byte 3 (if present) 

Sense Byte 4 (if present) 


re) 


CONDOR NM =| © 


1 SRCs 0000 through OFFF are 2-byte SRCs. SRCs 100000 through FFFFFF are 3-byte 
SRCs. 
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Workstation and printer SRCs (0100 through O3FF) use all 5 sense bytes to report 
information to the log. Table 13-20 describes the information contained within the 


5 sense bytes. 


Table 13-20. Sense Byte Information 


Sense Byte Sense Bits! 
0 
0 
1 
2 
3 
4 
5 
6 
7 
, 
0 
1 
2 
3 
4 
5 
6 
t 
2 
0 
1 
2 
3 
4-6 
B'001' 
B'010' 
B'011' 
B'100' 
B'101' 
B'110' 
B'111' 
7 
3 
4 
0-7 


Information 


Switches 

Temporary error 

Missed activate write 

Scan error code 

Quiesce 

The expected data stream was too short 
The expected data stream was too long 
Unexpected condition encountered 
Timer 1 is hung in busy mode 


Switches 

Reserved 

No response received 
Transmit activity check (TAC) 
Twinaxial port is defective 
Received parity error 

Wrong length information 
Wrong address 

Even/odd parity stop 


Poll Response 1 

Unexpected condition encountered 
Transmission parity error 

Reserved (terminals); unit available (printers) 
Unclaimed outstanding status 

Unexpected exceptions 

Null/attribute (terminals): activate parity lost (printers) 
Activate not valid 

Reserved 

Command not valid 

Buffer overrun 

Register not valid (terminals); reserved (printers) 
Power-on sequence 

Reserved 


Poll Response 2 


Printer Status or Switches 
Reserved 


1lf the bit is 1 (on), the condition applies. If the bit is O (off), the condition did not take place. 
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REQMS | | 

The AS/400 system sends the REQUEST MAINTENANCE STATISTICS (REQMS) 
command to request the error log and statistical counters from the 5494. The 5494 
replies to the REQMS with a RECFMS containing the formatted error log and 
counters. Table 13-21 provides the format of the REQMS command. 


Table 13-21. REQMS Format 


Bytes 


0-2 
0 


13-28 


Bits 


0-1 
2-/ 


0-31 


Field Value Description 
Network Services Header 
Involves PU or LU B'01' PU only 
Header type B'000001' Network Services header 
Domain B'0' Same domain 
Reserved B'0' 
NS category B'000011' Maintenance Services 
Request code X'04' REQMS command 
CNM header X' XXXXXXXX' Not checked by the 5494 but 
echoed in RECFMS response 
Reset indicator B'0' Ignore. The 5494 always resets 
or data when RECFMS sent in 
reply. 
B'1' Reset data when RECFMS sent 
in reply. 
Reserved B'0' 7 
Type code B'000001 ' Type code of 1 
: or or 
B'000100' Type code of 4 
RSHUTD 


The 5494 sends the REQUEST SHUTDOWN (RSHUTD) command to the AS/400 
system to indicate that it is ready to end the current LU-LU session. The RSHUTD | 
command is always sent on the expedited flow. The 5494 sends RSHUTD when 
an unrecoverable hardware failure occurs during an active session. The request 
code (RU byte 0) for RSHUTD is X'C2'. 


SIGNAL 

The SIGNAL command passes a signal code from LU to LU. SIGNAL is not 
affected by the state of the normal flow. SIGNAL is always sent and received on 
the LU-LU expedited flow. Higher level protocols use SIGNAL to assist with device 
timeouts and Help key functions. The request code (RU byte 0) for SIGNAL is 
X'C9'. The 4-byte signal code contained in RU bytes 1-4 is summarized in 

Table 13-22 on page 13-29. 


Functions Reference 


Table 13-22. SIGNAL Code Definition 


Signal Code 
00000001 
00000002 


00000005 
00010000 


00010001 
O0002xxxx 


0003022x 1 
0003023x 
0003024x 
0003025x 
0003026x 
0003028x 


Description 
Turn on the display Message Waiting indicator and sound the audible alarm. 


Resume data transfer. 
Sent when a printer intervention required error is resolved. 
SIGNAL 000302xx reports the error. 


Turn off the display Message Waiting indicator. 


Sent when the AS/400 system requests the CD bit back to send a request on the LU-LU 
normal flow. 


Sent when the operator presses Attention on the workstation. 


Sent when the operator presses Help on the workstation while in error state. The 2-byte error 
code (xxxx) is encoded as four binary-coded decimal digits. This error code reflects the 
current error code displayed in columns 2-5 of the workstation error line. 


Printer command or parameter not valid. 

Print check. 

Forms check. 

Normal periodic condition (end of file [EOF] reached or unit not ready). 
Printer data stream error. 


Printer machine, print or ribbon check. 


1 Refer to your printer documentation for specific information on 000302xx class errors. 


UNBIND 

The UNBIND command ends the LU-LU session. The AS/400 system sends this 
command on the LU-LU expedited flow. The 5494 accepts any valid UNBIND 
command when the LU is in an LU-LU session. All LU-LU session parameters and 
SNA states are reset after the UNBIND command, and the 5494 sends the AS/400 
system a positive response. 


Table 13-23 shows the format of the UNBIND command. The UNBIND response 
includes only the request code (RU byte 0). 


Table 13-23. UNBIND Command Format 


Bytes Bits Field Value _— Description 
0 0-7 Request code X'32' UNBIND command 
1 0-7 UNBIND type X'01' Normal end of session 1 


X'06' Session parameters not valid 1 


1Any value is accepted here. 
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SNA LU 4 and LU 7 Negative Responses 


The SNA SRCs are part of a negative response format. The sense data included 
bit is turned on in the response header (byte 0, bit 5) and is used to indicate that 
an error has occurred. The information that explains the error is contained in a 
4-byte field. When user-defined data cannot be included in the sense data, a 
sense code is substituted for the user-defined data. The sense data (the negative 
responses) in the 4-byte field have the following format: 


User-Defined Data 
Category Code (1 byte) Modifier Code (1 byte) User Byte 1 User Byte 2 
XX XX yy ZZ 


' The category code is a standard SNA code that identifies the error class: 


Value Category 
X'08! Request reject 
X'10' Request error 
X'20' State error 
X'40' RH usage error 
X'80' i Path error. 


Note: All other values are reserved. 


The three types of negative responses are: 


e SNA session responses (Table 13-24) 
e Device and cable error responses (Table 13-25 on page 13-31) 
e Data stream responses (Table 13-26 on page 13-32). 


Table 13-24 (Page 1 of 2). SNA Session Responses 


Category/Modifier 
0801 


0809 


0813 
0815 
0821 


0829 
082D 


1003 


2002 


User Byte 1 User Byte 2 Description 


00 00 AS/400 system issued a BIND command to an 
. unavailable resource 


02 00 Resource not available; when attempting a copy to 
printer function, the printer was off, bound, or 
attached to the wrong port 


00 00 Mode inconsistency; an ACTLU command is issued 
when the command is already in process 

00 00 Begin bracket that is not valid was received 

00 00 A BIND command was received while in session 

00 00 Parameters that are not valid were sent to the printer 
on the BIND or ACTLU commands 

01 00 A request was received that required the change of 
direction (CD) bit to be set to on 

01 00 A valid command was rejected because the LU was 
busy 

00 00 SNA command error; BIND or RSHUTD command 
that is not valid received; SS message sent to the 
printer 

00 00 Chain error detected 
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Table 13-24 (Page 2 of 2). SNA Session Responses 


Category/Modifier 
2004 


8004 
8005 


User Byte 1 
00 


00 
00 


User Byte 2 
00 


00 
00 


Description 


SNA request received while in send state; 5494 
previously received CD bit 


The specified LSID is not assigned to an LU 


No session open for specified LU 


Table 13-25 (Page 1 of 2). Device and Cable Error Responses 


Category/Modifier 
081C 


User Byte 1 


00 
01 


02 


User Byte 2 
00 
00 


01 
03 
04 
05 
06 
07 
08 


09 
20 
21 
22 
23 
24 
25 


26 
49 


89 
90 
91 
00 


01 
03 
04 
05 
06 
07 


Description 
Twinaxial port malfunction; no response to the POLL 


Workstation malfunction; no response timeout; 
workstation turned off during copy-to-printer operation 


Workstation malfunction; transmit activity check 
Workstation malfunction; received parity error 
Workstation malfunction; line parity check 
Workstation malfunction; the station is not accessible 
Workstation malfunction; received length check 
Wrong workstation responded 


Workstation power is in Transition mode from on to 
off or off to on 


Workstation could not be activated 

Command or device ID received that is not valid 
Register value that is not valid was encountered 
Workstation buffer or input queue was overrun 
A null attribute was found (exception error) 

An ACTIVATE command found that is not valid 


Workstation issued an exception response that is not 
valid 


Workstation pass-through interface error 


The workstation issued an invalid POLL or READ 
response 


The workstation’s outstanding status is erroneous 
Timeout on the even/odd status of the workstation 
Workstation busy timeout 


Printer malfunction; no response timeout; printer 
turned off during copy-to-printer operation 


Printer malfunction; transmit activity check 
Printer malfunction; received parity error 

Printer malfunction; line parity check 

Printer malfunction; the station is not accessible 
Printer malfunction; received length check 


Wrong printer responded 
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Table 13-25 (Page 2 of 2). Device and Cable Error Responses 


Category/Modifier User Byte 1 


User Byte 2 
08 


09 
1X 
20 
21 

22 
23 
24 
90 
91 


Table 13-26 (Page 1 of 3). Data Stream Responses 


Category/Modifier User Byte 1 
0811 02 
1003 01 
1005 | 01 
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User Byte 2 
00 


01 


01 


05 
23 


03 


10 
11 
12 
13 
14 


1B 
1C 


1D 


21 
22 
23 


25 


Description 


Printer power is in Transition mode from on to off or 
off to on 


Printer could not be activated 

Printer processing check (device-dependent) 
Command or device ID that is not valid received 
Register value that is not valid was encountered 
Printer buffer or input queue was overrun 

A null attribute was found (exception error) 

An ACTIVATE command that is not valid found 
Timeout on the even/odd status of the printer 


Printer busy timeout 


Description 


The Cancel key of a printer was pressed when it was 
not in an error state 


The Cancel key of a printer was pressed when it was 
in an error state 


Command that is not valid encountered in data 
stream 


Clear unit alternate command not valid 


Command to enter text mode not valid for the 
keyboard or country language code used 


Format table resequencing error on display data 
stream 


Structured field length is not valid 

Structured field class or type is not valid 
Parameter is not valid in structured field 
Structured field minor structure length is not valid 


Parameter is not valid in structured field minor 
structure 


Data stream command is not valid in WP mode 


Data stream command is not valid in data processing 
(DP) mode 


Command not allowed on display with unlocked 
keyboard 


Premature data stream termination 
Write to display order row/col address is not valid 


The address in the Repeat to Address is less than 
the current workstation screen address 


Start-of-field order length not valid 


Table 13-26 (Page 2 of 3). Data Stream Responses 


Category/Modifier User Byte 1 User Byte 2 Description 
26 Start-of-field order address not valid 
27 Data in restore not valid 
28 Field extends past the end of the display 
29 Format table overflow 
2A An attempt was made to write past the end of display 
2B Start-of-header length not valid 
2C Parameter that is not valid is on the ROLL command 
2D Extended attribute type not valid 
2E RAM load parameter not valid 
2F Extended attribute not valid 
30 Start-of-field attribute not valid 
,O6S 6 \ 31 No escape code was found where it was expected 
32 WRITE ERROR CODE TO WINDOW command 
| row/col address is not valid 
33 WRITE ERROR CODE TO WINDOW command is 
not valid with the message error line that is in use 
34 SAVE PARTIAL SCREEN command was followed by 
an immediate read or another SAVE type command 
35 Continued entry field segment is not valid 
36 Word wrap not allowed for this type of entry field 
38 An attempt was made to write a scroll bar beyond the 
| last display column 
39 The total row/col, slider position (sliderpos), or display 
row/col on a scroll bar is not valid 
3A At least one selection field choice must be allowed to 
accept the cursor 
3B An attempt was made to write a selection field choice 
before column 1 or beyond the last display column 
3C An attempt was made to define too many selection 
field choices 
3D An attempt was made to define more than one 
default selected choice in a single choice selection 
field 
3E Too many windows defined. 128 windows are 
allowed. 
40 | Write Data command to non-entry field 
41 Too much data or too little data in a Write Data 
command 
42 An attempt was made to write a X'FF' character to 
the display screen. 
48 The Fax and Image feature is not supported on this 
device. 
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Table 13-26 (Page 3 of 3). Data Stream Responses 
Category/Modifier User Byte 1 User Byte 2 Description 


49 Data follows an image/fax download command in the 
data stream and the image/fax download command 
does not contain the last of the image data. No other 
commands are accepted until all the image/fax data 
has been received. 


4C The display is not capable of video delivery. 

4D The first 2 bytes of the PC/TV command were not 
| X'E201' or X'E301'. . 

4F Data stream longer than 16,368 bytes. 

80 The printer LSID sent in the copy-to-printer data 


stream from the AS/400 system was not in the SNA 
session table 


81 The LSID sent in the copy-to-printer data stream from 
the AS/400 system was not a printer LSID 

87 Self-check field length (self-check field > 33 bytes) 
not valid 

88 Self-check field control word not valid 

02 28 SCS command not valid | 

29 SCS parameter not valid 

2A Intelligent Printer Data Stream (IPDS parameter 
error) 


60 IPDS printer's multistatus functions are available 
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Chapter 14. Network Management Support 


This chapter discusses the 5494 Systems Network Architecture (SNA) Alert 
functions and the Response Time Monitor (RTM) features. 


5494 SNA Alert Support 


This section describes the 5494 SNA Alert function. These alerts respond to errors 
detected by the 5494 and are sent on the system services control point physical 
unit (SSCP-PU) session. With concurrent host attachment, alerts are sent to the 
primary host if the controller session with the primary host is active. If it is not 
active, the alert is sent to an alternate AS/400 that has an active controller session. 


SNA Alert Function 


The SNA Alert function sends problem determination information collected by the 
5494 to the SSCP-PU controller session, which then sends the alert information to 
the AS/400 system. If the 5494 session is down, no alerts are generated. 


The 5494 sends alert messages to the AS/400 system in response to any of the 
following errors: 


e Attached display station errors 

e Attached printer errors 

e LU6.2 CNOS negotiation errors 

e LU6.2 Controller session errors 

e Low-entry networking (LEN) node programmable workstation (PWS) errors 

e Logical unit (LU) 6.2 nonprogrammable workstation (NWS) device session 
errors | 

e Code change errors 

e LAN gateway errors. 


SNA Alert Operation | 


You do not have to customize the 5494 for the AS/400 system to receive device or 
communication error information. The 5494 uses the SNA Alert operation to notify 
you of any device, program, or communication errors occurring between the AS/400 
system and all devices attached to the 5494. The alerts also notify you of any 
problems you are having with the communication protocols already in use. The 
SNA Alert operation uses the system reference codes (SRCs) to help you 
determine which kind of problem is occurring: 


Table 14-1. SRC Code Prefixes and Descriptions 


SRC Error Description 
01xx | Attached Display Station Errors 
02xx Attached Printer Errors 
O3xx Unknown Device Errors 
A2XXXX LU6.2 CNOS negotiation errors 
A3XXXX LU6.2 Controller session errors 

~ 44xxxx LU 6.2 NWS Device Session Errors 
45XXXX LEN (PWS) 
5 1XXXx Code Change Errors 
5AXXXX LAN Gateway Errors 
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How the SNA Alert Operation Works 

The 5494 sends all alerts to the AS/400 system for viewing. However, if there is no 
controller session active with an AS/400 system, the alerts cannot be sent. te 
errors are still logged and stored in the 5494 error log. 


For SRC error codes 01xx, 02xx, and 03xx (twinaxial devices), the 5494 sends an 
alert back to a user for permanent SRC errors. See Table 14-1 on page 14-1. 


SNA Alert Format 


For all SNA alerts, the format is similar. The byte format of a generic alert request 
unit (RU) is defined in Systems Network Architecture Formats Manual 
(GA27-3136). Each alert is contained within the Network Management Vector 
Transport (NMVT) RU command. See “NMVT” on page 13-23 for more information 
about how the 5494 uses the NMVT command. The NMVT RU command contains 
an Alert Major Vector and a series of subvectors and subfields. The following 
format shows an SNA Alert: 


eR SReS See neesseees Start of Alert Format -------------------- 
NMVT Generic Alert 
Alert Major Vector 
SNA Address List Common Subvector 


Hierarchy Resource List Common Subvector (included for 
A2xxxx, 43xxxx, and 44xxxx errors) 


Generic Alert Subvector 
Probable Cause Subvector 
Failure Cause Subvector 
Failure Causes subfield 
Recommended Actions subfield 
Detailed Data subfield 
Product Set ID Subvector 
Product Identifier subfield 
Hardware Product Identifier subfield 
Code Engineering Change (EC) Level subfield 


Date/Time Subvector 


Local Date/Time subfield 
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Alert Forwarding 


The 5494 also forwards PWS-issued alerts to the AS/400 system. For more 
information about alert forwarding, see Chapter 12, “Programmable Workstation 
Support.” 


The SNA Response Time Monitor 


This section describes the SNA Response Time Monitor (RTM) feature as it applies 
to the 5494. It contains the following sections that help describe how the RTM 
feature works for you: 


e RTM overview 
e Activating the RTM 
e Exceptions to the SNA RTM Function with the 5494. 


RTM Overview 


The RTM is an SNA feature that enables the AS/400 system to collect performance 
information about nonprogrammable workstations (NWSs) attached to the 5494. In 
brief, the response time is the time-lapse between the moment a user presses 
Enter or a command key and the moment more information can be entered. 


The RTM reports provide you with information to analyze: 


e General performance problems 
e Inadequate hardware performance 
e Infrequent hardware usage. 


The AS/400 system Performance Monitor sends RTM requests and responses. 
The Performance Tools Licensed Program (LP) reports the RTM information. 


Refer to the following manuals for more detailed information about AS/400 RTM 
support: 


¢ Systems Network Architecture Formats 
e Systems Network Architecture Management Services Reference. 


Activating the RTM 


Once the Start Performance Monitor (STRPFRMON) command (along with the 
associated remote response time [RRSPTIME] parameter) is specified from the 
AS/400 system, the RTM feature is activated. The RRSPTIME parameter specifies 
the remote workstation response time categories. The AS/400 performance 
monitor keeps track of interactive response times for each remote workstation 
attached to the 5494, which collects the response time information. If the 5494 is 
configured for concurrent host attachment, it collects information only for those 
workstations communicating with the AS/400 system requesting the information. 


The STRPFRMON command submits the performance monitoring job called the 
QPFRMON to the job queue identified in the job queue parameter 
(STRPFRMON(JOBQ)). Once the job is started, it periodically collects performance 
information and puts it into the system-supplied database files. The data is 
collected at intervals specified in the interval parameter 
(STRPFRMON(INTERVAL)). Refer to the Application System/400 Control 
Language Reference for more information about the STRPFRMON command. 
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Once the RTM feature is activated, it collects performance information about your 
NWS workstations attached to the 5494. The 5494 collects interna! performance 
information based on parameters from the Request RTM MS Major Vector sent 
from the AS/400 system. The 5494 responds to the AS/400 system with the RTM 
MS Major Vector. A response from the 5494 results from the following requests: 


e A request from the AS/400 system (solicited) 
e When a device session becomes inactive (unsolicited) 
e When a counter overflow occurs (unsolicited). 


When the 5494 sends responses to the AS/400 system, one vector is sent for each 
device that is being analyzed by the RTM feature. When the AS/400 system 
receives RTM responses (MS Major Vector) from the 5494, they are sent by the 
NMVT RU command. The NMVT RU format as sent by the 5494 is summarized in 
Table 13-14 on page 13-24. 


Exceptions to the SNA RTM Function with the 5494 


The 5494 supports the general SNA RTM feature in much the same way as the | 
SNA RTM feature is supported by other control units. The RTM commands and 
responses are supported in the same way as those listed in Systems Network 
Architecture Formats, with the following exceptions: 


e In the Request RTM MS Major Vector, the SNA Address List Common 
Subvector value, X'04', requesting performance information for a single 
device, is not supported. For example, you can set up a request for 
informational statistics, set recording on, and set recording flags. But you must 
set these requests for all devices, not just one. However, there are two 
conditions when the RTM feature sends unsolicited performance information 
about one device to the AS/400 system, they are as follows: 


— lf a device session becomes inactive and the AS/400 system has requested 
return of data unsolicited on device deactivation, the information for this 
single device is sent unsolicited to the AS/400 system. 


— lf an RTM counter overflows for a device and the AS/400 system has 
requested return of data unsolicited on the counter overflow, the information 
for this single device is sent unsolicited to the AS/400 system. 


e Only one RTM performance analysis definition value is supported, X'02'. This 
value is used to measure performance from when the Attention key or the 
Action key is pressed until the device is ready to accept input from a user 
again. 


e The correlation value in the RTM Status Reply Subvector is not supported. 
The 5494 always sets it to zero (0). 


e The RTM feature becomes inactive when the following occurs: 


— The 5494 that is attached to the AS/400 system is varied off. 
— The 5494 connection to the AS/400 system fails. 
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Chapter 15. Display Data Streams 


The 5494 uses format tables in storage to control the presentation of data on NWS 
screens. Since the 5494 supports simultaneous operation of up to 56 workstations, 
space is reserved for 56 separate format tables. The 5494 constructs these tables 
at format level O during initialization. This structure supports the Free Key mode of 
workstation operation and includes the following characteristics: 


e A single input field that includes the entire screen 
e Alphanumeric characters only 

¢ Base field attribute 

e Cursor at row 1 column 2 (home position) 

e Error line at row 1. 


The workstation writes keystroke scan codes into its storage buffer and sends 
these codes to the 5494. The 5494 translates each scan code to its EBCDIC 
equivalent, and returns this character code for display on the screen. — 


Certain data transfers between the AS/400 system and a workstation occur 
immediately after establishing an SS-LU session. Application programs supply the 
commands required to control overall workstation operation. The AS/400 system 
transmits individual commands to the 5494 within request/response units (RUs) of 
the output data stream on the LU-LU session flow. An output data stream begins 
with a command, but RUs might not. The AS/400 system can organize a number 
of RUs into a logically linked chain that can also include graphics characters and 
control information. When an output data stream contains a READ command, the 
5494 returns an input data stream that consists of a read header followed by data 
from either the format table or directly from a workstation regeneration buffer. 


The 5494 now concatenates all RUs in a chain into one block and processes the 
data stream in one step after the concatenation is complete. This method results in 
better processing performance, reduces screen flashing, and presents the entire 
screen of information at one time. 


Note: In this book, all data strings are presented with the most significant byte on 
the left. Byte and bit numbers are also written from left to right beginning with byte 
0 bit O as the most significant bit. 


LU 4 and LU 7 SS-LU Session Data Stream 


The AS/400 system can initiate data transfer to a designated workstation whenever 
an SS-LU session is active. These transfers take precedence over LU-LU flows. 
However, each exchange consists of a single RU having no more than 128 bytes of 
unformatted data, of which no more than 78 bytes can be presented on the 
workstation screen. The 5494 will respond negatively to data on the SS-LU flow if 
the addressed workstation is in the pre-help error, post-help error, system request, 
or SS message state. If the 5494 accepts such a message, then: | 


e The workstation enters the SS message state. 
e The 5494 saves the contents of the error line for the addressed workstation. 


e The 5494 alters the format table by writing attributes of normal intensity, 
nonblink, and nonreverse image to column 1 and non-display to column 80 of 
the error line. 
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e The first 78 display characters in the SS message appear on the error line 
beginning at column 2. 


The SS message remains on the screen until the workstation operator resets the 
workstation. At that time, the 5494 erases the SS message and returns the original 
data to the screen. 


The workstation operator initiates input to the AS/400 system on the SS-LU flows 
with a system request or test request key sequence. When the workstation 
operator enters the correct sequence for a particular workstation the following 
actions Occur: 


e The 5494 saves the current contents of the input line and sets the attributes as | 
previously described for incoming SS messages. 


e The 5494 writes a row of column separator blanks to the input line. 


e Input line remains blank until the workstation operator types the desired input 
message. 


e When the workstation operator presses Enter, the 5494 sends the contents of 
the input line to the AS/400 system without cursor address or attention identifier 
(AID) code. 


Once the message has been sent, the 5494 returns the keyboard to its previous 
state and writes the original data on the input line. 


LU 4 and LU 7 LU-LU Session Data Stream Formats 
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LU-LU session data streams consist of commands transmitted to the 5494 and 
responses sent back to the AS/400 system. In general, each command includes an 
escape character (X'04'), a 1-byte command code, and a data field of varying 
length. When a single transmission contains more than one command, the escape 
character serves as a delimiter that identifies the first character of the next 
command code. 


The 5494 generates a return data stream in direct response to a command, or 
waits until the user presses a control key. Each response begins with the current 
address (row and column) of the cursor, an AID code associated with a particular 
control key, and the data specifically requested by the AS/400 system. The 5494 
supports the following data stream commands; however, not all 5250 workstation 
controllers support all of the following commands and orders. The “5250 QUERY 
Command” on page 15-133 can help you determine individual workstation 
Capabilities. | 


The 5494 supports three different modes of operation that determine overall 
characteristics of LU-LU data streams: 


Data Processing (DP) Mode. While operating in DP mode, the 5494 uses 
format tables to maintain direct control over displays presented on each NWS. 
The AS/400 system uses data stream commands to write control data into the 
format table, write data to the workstation, or request a readout of data from 
the workstation. 


In DP mode, the 5494 supports 5250 data stream features enabling the user to 
define graphical user interface (GUI) capabilities as well as various entry field 
types for NWSs. | 
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Word Processing (WP) Mode. When the 5494 is in WP mode, the format 
tables serve as storage buffers but do not provide direct control over 
workstations. This change in internal operation prevents the 5494 from 
accepting certain combinations of data stream commands. 


Pass-Through Data Stream Processing. Pass-through data streams are 
normally reserved for printers. However, because PWSs respond directly to 
commands from the AS/400 system, the 5494 merely coordinates data 
transfers for these devices. In this case, the detailed characteristics of LU-LU 
session data streams depend on the workstation in use and the application 


program being run. 


Table 15-1 lists the name, code, and application for each command accepted by 
the 5494. Subsequent sections in this chapter provide detailed descriptions of 


command structures and control formats. 


Table 15-1 (Page 1 of 2). Workstation Data Stream Commands 


Command 

CLEAR UNIT 

CLEAR UNIT ALTERNATE 

CLEAR FORMAT TABLE 

WRITE TO DISPLAY 

WRITE ERROR CODE 

WRITE ERROR CODE TO WINDOW 1 
READ INPUT FIELDS 

READ MDT FIELDS 

READ MDT ALTERNATE 1 

READ SCREEN 

READ SCREEN WITH EXTENDED ATTRIBUTES 1 
READ SCREEN TO PRINT 1 


READ SCREEN TO PRINT WITH EXTENDED 
ATTRIBUTES 1 


READ SCREEN TO PRINT WITH GRIDLINES 1 


READ SCREEN TO PRINT WITH EXTENDED 
ATTRIBUTES AND GRIDLINES 1 


READ IMMEDIATE 
READ MODIFIED IMMEDIATE ALTERNATE 1 
SAVE SCREEN 

SAVE PARTIAL SCREEN 1 

RESTORE SCREEN 

RESTORE PARTIAL SCREEN 1 

ROLL | 

WRITE STRUCTURED FIELD 1 


WRITE SINGLE STRUCTURED FIELD 


Command 


Code 
X'40' 
X'20' 
X'50' 
X'11! 
X'21' 
X'22!' 
X'42! 
X'52!' 
X'82! 
X'62' 
X'64' 
X'66! 
X'68' 


X'6A' 
X'6C! 


X'72' 
X'83' 
X'02' 
X'03' 
X12 
X13 
X'23' 
X'F3' 


X'F4! 


Modes 

DP Mode and WP Mode 
DP Mode and WP Mode 
DP Mode and WP Mode 
DP Mode 

DP Mode and WP Mode 
DP Mode 

DP Mode 

DP Mode 

DP Mode 

DP Mode and WP Mode 
DP Mode and WP Mode 
DP Mode 

DP Mode 


DP Mode 
DP Mode 


DP Mode 
DP Mode 
DP Mode and WP Mode 
DP Mode 
DP Mode and WP Mode 
DP Mode 
DP Mode 


DP Mode 2 and WP 
Mode 3 


DP Mode 
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Table 15-1 (Page 2 of 2). Workstation Data Stream Commands 


. | Command 
Command © Code ‘Modes 
COPY-TO-PRINTER 1 X'16' WP Mode and DP Mode 


1 Some non-5494 workstation controllers do not support this command. A negative 
response is returned if this command is used. 


2 In DP mode, only the DP mode WRITE STRUCTURED FIELD commands are valid. 
3 In WP mode, only the WP mode WRITE STRUCTURED FIELD commands are valid. 


CLEAR UNIT Command 


The AS/400 system issues the CLEAR UNIT command to clear both the 
workstation screen and format table. The command code is X'40'. 


ESC CLEAR UNIT 
X'04' X'40' 


When the 5494 receives a CLEAR UNIT command, it: 
e Locks the workstation keyboard 
e Turns the keyboard clicker off 
e Turns the input inhibited indicator on 
e Clears the error state (or system request state) 
e Clears the Insert mode (with its associated indicators) 


¢ Clears the Diacritic mode (with its associated indicators), unless type-ahead 
mode is active 


e Clears the Command mode, unless type-ahead mode is active 

e Resets any keystroke processing state 

e Clears the format table (with its effects on the keyboard shift state) 
e Clears the modified data tag (MDT) bit 

e Resets read sequencing 

e Sets up all PF or Command keys to return data 


e Clears the workstation screen by writing nulls to the regeneration buffer and 
nulling any extended attributes 


e Erases any fax or image from workstation memory 


| e Sends SET VIEW MODE TO OFF and TURN AUDIO OFF commands to the 
| workstation if 5250 Video Delivery video or audio is active.’ 


e Screen size is set (reset) to 24 rows by 80 columns 


e Writes an attribute byte to row 1, column 2 of the display with the following 
characteristics: 


| 1 Keyboard contro! of the PC/TV is not aiiacied: Other PC/TV values such as sishuiie in picture (PIP) location, PIP size, channel, 
| volume, and so forth, are not modified. 
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— Nonblink 
— Nonreverse video 
— Normal intensity. 


# Places the cursor (blinking) at row 1, column 1 and sets this address as the 
insert Cursor address 


e Clears any AID request not already serviced 
e¢ Clears any pending READ INPUT or READ MDT commands. 


e For older displays without a separate message line, line 24 is set as the 
message line. For displays with a separate message line, the message line is 
set as the default. 


If the workstation is in SS message state, the 5494 rejects the CLEAR UNIT 
command and returns a contention error negative response. 


CLEAR UNIT ALTERNATE Command 


The AS/400 system issues the CLEAR UNIT ALTERNATE command to clear the 
display screen and the format table of display stations that support screen sizes 
other than 24 rows by 80 columns. It can also be used to clear a screen without 
erasing image/fax data. If the AS/400 system issues this command to a display 
station that does not support the screen size requested, the 5494 rejects the 
command with a negative response of 10030101. The command code is X'20'. 


ESC CLEAR UNIT ALTERNATE. PARAMETER 
X'04" X'20' 1 byte 


The values for this parameter byte are: 


Parameter 

Byte Meaning 

X'00' . Set screen size to 27 rows by 132 columns. 

X'80' Leave the screen size unchanged and do not erase image/fax 


data from the display memory. If image/fax data were visible 
before this command was processed, it would still be visible 
after this command is processed. 


Note: The CLEAR UNIT ALTERNATE command with 
parameter X'80' should be used only within an image/fax 
application and not between applications. 


If the 5494 receives any other parameter values, it returns a negative response of 
10030105. 


CLEAR FORMAT TABLE Command 


The AS/400 system issues a CLEAR FORMAT TABLE command to erase the 
contents of the format table without affecting the data on the workstation screen. 
The command code is X'50'. 


ESC CLEAR FORMAT TABLE | 
X04! X'50! 
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The 5494 processes this command in the same way as the CLEAR UNIT 
command, with the following exceptions: 


e Presentation screen size remains the same. 

¢ Attributes remain the same. 

e The cursor remains in its current screen position. 

e The AS/400 system does not reset error state or system request state. 


For 5250 displays without a separate message line, and for displays with a 
separate message line that is not being used for the error line, the 5494 rejects this 
command with a contention error if the addressed display is in pre-help error, 
post-help error, system request, or SS message state. For displays that are using 
the separate message line as the error line, contention errors are generated only 
for system request or SS message state. 


WRITE TO DISPLAY Command 


The AS/400 system issues the WRITE TO DISPLAY (WTD) command to modify 
the contents of the format table and regeneration buffer associated with individual 
display stations. The command code X'11' marks the beginning of the WTD 
command, followed by a 2-byte control character and a combination of display 
parameters and orders. 


WRITE TO DISPLAY Control Parameter 


X'11! Character (see Figure 15-1 on 
2 bytes page 15-7) 





Figure 15-1 on page 15-7 shows how data streams may be combined during a 
WTD operation. 
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Escape 


Write-to-Display 


Control Characters 
























Write to Display 
Structured Field 
Order, Write 

Structured Field 






Start-of-Header 
Parameters 


Transparent Data, Set Buffer Address, 


Row, Column 
Address 


Field Length, 
Data 





Start-of-Field 
Field Format Word 
Field Control Word 


Screen Attribute 
Field Length 





Data 


Characters 












Write Extended Attribute, 
Attribute type, 
Attribute 













Erase to Address, 
Row, Column, 
Length 


Attribute Types 





Move Cursor, Row, 
Column Address 


Repeat to Address, 
Row, Column 
Address and 
Character 











insert Cursor, 
Row, Column 
Address 


Figure 15-1. Valid Data Stream Combinations during WRITE TO DISPLAY 
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The 5494 rejects the WTD command and returns error messages under the 
following conditions: 


e Ifa display without a separate message line, or one that has a separate 
message line but has selected a different error line, is in the pre-help error, 
post-help error, system request, or SS message states 


e If a display that supports a separate error line and has the separate error line 
selected is in the system request or SS message state, or a start of header 
(SOH) order is received that attempts to change the selected error line while 
the error line is in use 


lf the 5494 accepts the command but detects a parameter error during processing, 

it rejects the incorrect parameter and all data in the remainder of the SNA chain. In 
addition, the 5494 does not process the second byte of the control character at the 

beginning of the command. While the 5494 is processing a WTD command: 


e If the WTD command changes the format table, the keyboard remains locked 
until specifically unlocked by a control character or by a subsequent WTD 
command. 


e If the WTD command contains a parameter error, the state of the keyboard 
depends upon parameters that preceded the error. 


e If the WID command is valid, after the command is processed, the cursor 
moves to one of three locations: 


— The location set by an insert cursor order (unless control character byte 1, 
bit 1 is equal to B'1'.) 


— The start of the first non-bypass input field defined in the format table 


— A default starting address of row 1 column 1. 


Control Characters 


The 2-byte control character immediately following the WTD command code 
determines which state the keyboard enters at the start of command processing 

_ and which state the workstation enters after command processing is successfully 
completed. Table 15-2 on page 15-9 and Table 15-3 on page 15-9 identify the 
functions associated with these 2 bytes. 
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Table 15-2. WRITE TO DISPLAY Command Control Characters, Byte 0 


Reset MDT Null all 
Reset pending flags in Reset MDT non-bypass Null all 
AID, lock non-bypass flags in all fields with non-bypass 
Bits 0-2 keyboard fields fields MDT on fields 
B'000' 
B'001' X 
B'010' X X 
B'011' X X 
B'100' X X 
B'101' X X X 
B'110' X X X 
B'111' X X X 
Notes: 


1. Bits 3 through 6 are reserved and should be set to B'0000'. 


2. If bit 7 is set to on, the data in the WRITE TO DISPLAY command is non-stream data and is written to the 
workstation without data stream optimization. If bit 7 is set to off, the data in the WRITE TO DISPLAY command 
and subsequent keystrokes may be optimized to improve performance. 


Table 15-3 (Page 1 of 2). WRITE TO DISPLAY Command Control Characters, Byte 1 


Bit Code Meaning 
0 - Reserved 
1 B'0' Cursor moves to default or insert cursor (IC) order position when keyboard unlocks 1 
B'1' Cursor does not move when keyboard unlocks ae 5. AS ee eee bute OP fen tag sma 
2 B'0' No action % ie: - Ad Cutters, bame, pos vine@w fo 
B'1' Reset blinking cursor 2 
3 B'Q' No action 
B'1' Set blinking cursor 2 
4 B'0!' No action 
B'1' Unlock the keyboard and reset any pending AID bytes 3 
5 B'0O' No action | 
B'1' Sound alarm 
6 B'0' No action 
| B'1' Set Message Waiting indicator off 4 
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Table 15-3 (Page 2 of 2). WRITE TO DISPLAY Command Control Characters, Byte 1 


Bit Code Meaning 
7 B'O!' No action 

B'1' Set Message Waiting indicator on 4 
Notes: 


1. An exception is when a WTD is received when the keyboard is unlocked and the WTD does not modify the 
keyboard state; then the cursor is not moved. 


2. If bits 2 and 3 are both on, the cursor blinks. For the IBM 5292 Color Display Station, bits 2 and 3 will be effective 
only if the workstation operator does not use the blink cursor function. 


3. If the keyboard is already unlocked, this bit is ignored; otherwise, it: 
a. Unlocks the keyboard. 
b. Turns the keyboard clicker on. 
c. Turns the Input Inhibited indicator off. 
d 


. Moves the cursor to the address given in the last IC order or defaults to the first position of the first 
non-bypass input field if no IC order has been given. If there is no non-bypass field, it defaults to row 1, 
column 1. 


e. Clears all unserviced AID requests. 
The 5494 defers this process until after the operator presses the Error Reset key, if in operator error state. 


4. If bits 6 and 7 are both on, the Message Waiting indicator is set to on. 


_ Data Characters 
Data characters can be placed in the data stream following the WTD control 
characters. The data characters are generally greater than or equal to X'20' and 
less than or equal to X'FE'. X'FF' is not a valid data character. 


The null character (X'00'), duplicate character (X'1C'), field mark character 


(X'1E'), ideographic shift-in (X'OE'), and ideographic shift-out (X'OF') are valid — 
data characters. 
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WTD Orders List 


The WTD command can include different parameters. The following paragraphs 
describe the functions listed in Table 15-4. 


Table 15-4. WTD Orders 











Name Abbreviation Code (Hex) 
Set buffer address order SBA 11 
Insert cursor order IC 13 
Move cursor order 1 MC 14 
Repeat to address order RA 02 
Erase to address order 1 pie me EA 03 
Start of header order | | SOH 01 
Transparent data order 1 TD 10 
Write extended attribute order 1 WEA 12 
Start of field order PADS NA SF 1D 
Write to Display Structured Field Order 1 pis 3 4 WDSF 15 
Notes: 

1 Some non-5494 workstation controllers do not support this order. 


Set Buffer Address Order 
The set buffer address (SBA) order specifies the address at which data transfer 
and input field definition will begin. Any location within the boundaries of the 
workstation presentation screen is valid. The order code is X'11'. 


SBA Row Address Column Address 
X41! 1 byte 1 byte 
The row is equal to 1 and the column address is equal to 0, followed by an SF field 


starting in row 1, column 1. Any other use of 0 in row or column address results in 
a parameter error. 


insert Cursor Order 
The insert cursor (IC) order specifies the position of the cursor when the AS/400 
system unlocks the keyboard or when the workstation operator presses the Home 
key. The order code is X'13'. 


IC Row Address Column Address 
X'13' 1 byte 1 byte 


The 5494 saves the row and column addresses in the IC order within the control 
block assigned to the workstation. If multiple IC orders exist within a single WTD 
command, only the last one in the command is retained. The last IC or MC order 
in the command determines cursor position. See “Move Cursor Order” on 

page 15-12. Any address within the boundaries of the display is valid. 
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Move Cursor Order | 
The move cursor (MC) order allows the AS/400 system to move the cursor to a 
specified position without modifying the home address and without regard to the 
state of the keyboard. The order code is X'14'. 


MC Row Address Column Address | 
X'14' 1 byte 1 byte 
If multiple IC or MC orders are coded in the WTD data stream, the last IC or MC 
order determines cursor position. The IC order negates any previously coded MC 
orders. The MC order negates any previously coded IC orders, with the exception 


that the last IC order establishes home position. To set the home position and then 
move the cursor, code the IC order first, followed by the MC order. 


The MC order is not affected by WTD control character values, including the move 
cursor flag. See Table 15-3 on page 15-9. 


Repeat to Address Order | 
The repeat to address (RA) order results in the repetition of a selected character 
from the current workstation screen address up to and including the screen row and 
column addresses given in the order. The order code is X'02'. 


RA Row Address Column Address Repeated Character 
X'02' 1 byte 1 byte 1 byte 


The 5494 checks row and column addresses for validity. If the location in the RA is 
less than the current display address, the 5494 posts a parameter error. Although — 
you can insert any code point into the repeated character field of this order, avoid 
X'10', X'11', and X'FF'. These values may affect the display of data on displays 
with extended attribute buffers. The current display address is set to the location 
specified in the RA, plus one. 


Erase to Address Order 


The erase to address (EA) order clears selected extended attribute types and 
optionally clears the display screen. The order code is X'03'. 


EA Row Address Column Address Length List of Attribute 
X'03' 1 byte ~ | 1 byte 1 byte Types 


Valid length values are between X'02' and X'05' and include length of the length 
byte plus length of the list of attribute types. 


The valid extended attribute types are: 


X'00' Display screen 

X'01' Extended primary attributes 

X'02' Extended text attributes (used in WP mode only) 

X'03' Extended foreground color attributes 

X'05' Extended ideographic attributes 

X'FF' Display screen and all extended attribute types supported by this 
workstation. Use X'FF' to clear all extended attribute types for optimum 
performance, even if all types are not used. 
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When the 5494 receives this order, it checks the row and column address for 
validity. The 5494 then clears the selected attribute types from the current display 
address up to and including the screen row and column address given in the order. 
It then sets the current display address to the location specified in the EA plus one. 
The following conditions result in a negative response: 

e The row and column location in the EA is less than the current display address. 

¢ The length field is not valid. 

e A specified attribute type is not valid. 


e A specified attribute type is not supported on this workstation. 


Start of Header Order 


The start of header (SOH) order specifies header information for the format table. 
When the 5494 receives this order, it first clears the format table and then inserts 
the contents of the SOH order. Because the parameters in this order vary in 
length, the first byte after the control code contains the number of bytes included. 
The command code is X'01'. 






Length Flag RSVD ERR Command Key 
1 byte 1 byte X'0! Row Switches 
1 byte 3 bytes 


BYTE 0 Length of data following SOH order not including the length byte. 





Note: A value of 0 or a value > 7 is not valid and triggers a parameter 
error. 


BYTE 1 Flag byte 
Bit O—Right-to-left screen level cursor direction 
Bit 1-Reserved 
Bit 2-Automatic local screen reverse 
Bit 3—The cursor is allowed to move only to input-capable positions; this 
cursor movement mode applies to this display screen. 
Bits 4—7 Reserved. 


BYTE 2 Reserved. 


BYTE 3 The number of the first field that the control unit sends to the AS/400 
system in response to a READ INPUT FIELD, READ MDT FIELD, READ 
MDT ALTERNATE, READ IMMEDIATE, or READ IMMEDIATE 
ALTERNATE command. Specify 0 if resequencing is not desired. 


BYTE 4 ERR Row. 


For displays without a separate message line, line 24 is set as the 
message line. For displays with a separate message line, the message 
line is set as the default. 


SOH bytes 5, 6, and 7 contain the data included switches for the 24 PF keys. If 
the SOH byte 0 contains a value of 6 or less, all screen input fields are returned 
with every entry of a PF key. When bytes 5 through 7 are included with an SOH 
order, a set bit prevents input data and AID codes from being returned with a 
request from the corresponding PF key. Bits 0 through 7 of byte 5 represent PF 
keys 24 through 17, respectively. Bits 0 through 7 of byte 6 represent PF keys 16 
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through 9, respectively. Bits 0 through 7 of byte 7 represent PF keys 8 through 1, 
respectively. 


Transparent Data (TD) Order 


_ The transparent data (TD) order allows the transmission of data with any value to 
the workstation screen. The order code is X'10'. 


TD LL 
X'10! 2 bytes 


The 2-byte field (LL) immediately after the order code indicates the total length of 
the data field. The 5494 returns a parameter error if: 


e Fewer than 2 bytes remain in the data stream when the TD order is found 


e The AS/400 system attempts to write data beyond the last available screen 
address 


e The data stream contains fewer bytes than indicated by the LL field. 


Notes: 


1. Ideographic data should not be written to the display screen using the TD 
order. 


2. Do not write X'FF' to the display screen of any display that has an extended 
character buffer (ECB). 


Write Extended Attribute Order 


15-14 


The write extended attribute (WEA) order allows an extended attribute to be written 
to the workstation extended character buffer (ECB) at the current workstation 
address. The order code is X'12'. 


WEA Attribute Type Attribute 
| X'12!' 1 byte 1 byte 


The valid extended attribute types are: 


X'01' - Extended primary attributes 
X'03' - Extended foreground color attributes 


X'05' - Extended ideographic attributes 


Valid Extended Primary Attributes 

_ The valid extended primary attributes are X'00' and X'80' to X'9F', as defined in 
Table 15-5. X'80' is the normal display attribute. X'OO' is the null attribute and 
does not change the current extended attribute in effect. 


Table 15-5 (Page 1 of 2). WEA Extended Primary Attributes 


Bits Description 


0 Attribute flag 


1 = Attribute change 


1-2 Reserved 


Functions Reference 
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Bits Description 
3 Column separator 
1 = Column separator 
4 Blink 
1 = Blink 
S Underscore 


1 = Underscore 


6 Intensity 

1 = High intensity 
7 Reverse image 

1 = Reverse image 


Extended primary attributes generally take precedence over display screen 
attributes. If an X'80' extended primary attribute is in effect or if the entire 
extended attribute buffer is nulled, the display screen attributes affect display 
screen presentation. 


Valid Extended Foreground Color Attributes 
The valid extended foreground color attributes are X'00' and X'80' to X'8F'. The 
display support of extended foreground color attributes can be determined using the 


5250 QUERY command (5250 Query Response field definition within Device 
Capabilities, byte 2, bits 6—7). Valid extended foreground color attributes are 
defined as follows: | 


X'00' Null - continue currently defined attribute 

X'80' Color of the display background medium; black on most models 
X'81' same as X'80' 

X'82' blue | | 

X'83' blue; different shade of blue than X'82' on some displays 
X'84' green 

X'85' green; different shade of green than X'84' on some displays 
X'86' turquoise 

X'87' turquoise; different shade of turquoise than X'86' on some displays 
X'88' red 

X'89' red; different shade of red than X'88' on some displays 

X'8A' pink 

X'8B' pink; different shade of pink than X'8A' on some displays 
X'8C' yellow 

X'8D' yellow; different shade of pink than X'8C' on some displays 
X'8E' white 

X'8F' white; different shade of white than X'8E' on some displays 


Extended foreground color attributes begin at the position of the extended attribute. 
Null (X'00') extended attributes continue the currently defined attribute. A X'80' 
is the normal display attribute. All combinations of attributes between X'80' and 
X'8F' are valid on all displays with foreground color extended attributing capability. 


In general, if extended foreground color attributes are used, the extended 
foreground color attributes take precedence over display screen attributes. The 
exception is if a X'80' extended foreground color attribute is in effect, then display 
screen attributes do affect display screen presentation. 
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Valid Extended Ideographic Attributes 

The valid extended ideographic attributes are X'00', X'80', and X'81'. The 
display support of extended ideographic attributes can be determined using the 
5250 QUERY command (5250 Query response field definition within Device 
Capabilities, byte 3, bits 0-2). Extended ideographic attributes are defined as 
follows: 


X'Q0' Null - continue currently defined attribute 
X'80' Normal display attribute - end double byte mode (SI) 
X'81' Begin double byte mode (SO) 


Extended ideographic attributes begin at the position of the extended attribute. Null 
(X'00') extended attributes continue the currently defined attribute. 


In general, if extended ideographic attributes are used, they take precedence over 
display screen SO or SI characters. However, when the X'80' extended 
ideographic attribute is in effect, the screen SO or SI characters affect screen 
presentation. 


Extended ideographic attributes should not be written behind middle positions of 
input fields because the 5494 does not scan the extended ideographic plane to 
determine whether the cursor is in a single- or double-byte position. 


Do not place a X'80' attribute behind the second byte of a double-byte character. 
The next character is single byte, but the data returned fora READ SCREEN WITH 
EXTENDED ATTRIBUTES command splits the double-byte character. 


Do not mix extended ideographic attributes with screen SO characters. If an SO 
character is in effect on the screen, use a screen SI character before using an 
extended ideographic SO attribute. If an extended ideographic SO attribute is in 
use, use an extended ideographic SI attribute before using a display SO character. 


Two restrictions exist when using this command on an NWS: 


1. Whenever double-byte data is written between extended ideographic SO and SI 
attributes, the extended ideographic SO and extended ideographic SI attributes 
bounding the data must be written to the display using the WRITE EXTENDED 
ATTRIBUTE command. This is true even if the extended ideographic SO or SI 
attributes were previously written to the display. If this is not done, the AS/400 
will not correctly handle undefined double-byte code points. 


2. When using an extended ideographic SO attribute on the display screen, use 
only one of the following READ commands: 


e READ SCREEN WITH EXTENDED ATTRIBUTES 

e READ SCREEN TO PRINT WITH EXTENDED ATTRIBUTES 

¢ READ SCREEN TO PRINT WITH EXTENDED ATTRIBUTES AND 
GRIDLINES | 

¢ READ MDT FIELDS 

¢ READ MDT ALTERNATE 

e READ MDT IMMEDIATE ALTERNATE. 


Other READ commands do not identify double-byte data that is between the 
extended ideographic SO and extended ideographic SI attributes, causing the 
AS/400 to process undefined double-byte code points incorrectly. 


Functions Reference 


Considerations 

Extended attributes should be used for screen output fields only. If they are used 
in input fields, insert and delete processing will not move the extended attribute. 
The WEA order does not modify the current display address. 


The following conditions result in a negative response: 


e The specified attribute type is not valid. 

e The specified attribute type is not available on this workstation. 

e The specified extended attribute is not valid. 

e The specified extended attribute is not available on this workstation. 


Note: When using extended attributes, it may be necessary to null the attributes 
when the next display screen is written. A CLEAR UNIT command clears the 
screen and nulls all extended attributes. If, instead of issuing a CLEAR UNIT, the 
AS/400 system chooses to overwrite existing data (using, for example, an RA order 
to write nulls to an area of the screen), extended attributes may cause the screen 
to be displayed incorrectly. The EA order may be used to null display screen data 
and extended attributes. See “Erase to Address Order” on page 15-12. 


Start of Field Order 


The start of field (SF) order controls the characteristics of every input field that 
appears on workstation screens. The SF order can also define output fields that 
appear on the workstation screen. However, using an SBA order followed by data 
characters is preferred for better performance. The order code is X'1D'. SF 
orders include control words that determine the operating characteristics, display 
attributes, and length of individual fields. 


SF FFW FCW LL 
X'1D' 2 bytes 2 _ 1 oe 2 bytes 


\opan ples are allewed 
SF Start of field order. 


FFW Optional field format word (FFW). If specified, causes an input field to be 
defined. 


FCW Optional field control word or words (FCW). May not be specified unless 
FFW is coded. 


@ Leading field attribute. 
LL Field length. 
The 5494 can accommodate up to 256 input fields for each workstation. The 


maximum number of fields is not restricted by the number of FCWs defined. The 
5494 processes each SF order in the following manner: 


e Upon detection of the SF code, the 5494 first sets the SF address. This 
address is either determined by the contents of a preceding SBA order or 
calculated from the field length parameter in the last SF order received. 


e The 5494 examines the first 2 bits after the code to identify which word is 
present. If an attribute follows immediately after the code, an output field is 
being defined, and such fields require no entry in the format table. 


¢ If the 5494 detects an FFW in the SF order, it takes the following actions: 
— Locks the keyboard. | 
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— Clears Insert mode and the corresponding display on the keyboard. 
— Clears Command mode and any outstanding AID request. 


— Examines the format table for an entry that begins at the current starting 
address plus 1. If such an entry is detected, the 5494 modifies the existing 
field in accordance with the new FFW and leading field attribute. 


— If no field previously existed at the current starting address, and this field is 
after the last field on the display screen, the 5494 enters a new field in the 
format table in accordance with the FFW, and writes the leading and 
ending field attributes. 


Field Format Word 

The AS/400 system must configure a separate FFW for each input field on a 
workstation screen. This word contains software flags that define most of the 
operational characteristics supported by the 5494. Table 15-6 defines each bit or 
field included in the FFW. 


Table 15-6 (Page 171 of 2). Field Format Word Format 
Bit 0-1 01 — FFW identification flag 
Bit 2 Bypass 


0 = This is not a bypass field 
1 = This is a bypass field 


Bit 3 Dup or Field Mark Enable 
O = Duplication or Field Mark is not allowed in this field 
1 = Duplication or Field Mark is allowed in this field 


or a Se Se —— — = = ie 
0 = This field has not been modified 
1 = This field has been modified 


Bit 5—7 Field Shift/Edit Specification 
000 = Alpha shift 
001 = Alpha only 
010 = Numeric shift 
011 = Numeric only 
100 = Katakana shift 
101 = Digits only a . o: «B 
110 = I/O-(feature input field) <.... Maca viet ie a ioe) Poe. a 7 4 ae z 


111 = Signed numeric Sey WE fe 


Bit 8 Auto Enter 
O = No auto enter 
1 = Auto enter when field is exited 


Bit 9 Field Exit Required (FER) 
0 = Field Exit key is not required 
1 = Field Exit key is required 


se ROL alphanu Mane 


Bit 10 Monocase 
O = Accept lower case letters 
1 = Translate operator keyed letters to uppercase 


Bit 11 Reserved 


= = a ee i RES =e ae ee ee Te 
0 = Not mandatory enter field 
1 = Mandatory enter field 
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Table 15-6 (Page 2 of 2). Field Format Word Format 


Bit 13-15 Right Adjust/Mandatory Fill (MF) 
000 = No adjust specified 
001 = Reserved 
010 = Reserved 
011 = Reserved 
100 = Reserved 
101 = Right adjust, zero fill 
110 = Right adjust, blank fill 
111 = Mandatory fill 
Notes: 


1. The 5494 does not check FFW data for validity. 


2. 


The AS/400 system can write anything to any location on screen, regardless of FFW 


data in the format table. 


. The AS/400 system can set the MDT bit of.a particular field by placing an FFW at the 


proper place in the data stream. 


. Make sure that all bits marked as reserved are set to 0. 


Fields: Table 15-7 identifies the field formats that the 5494 supports. Selection of 
specific field formats is controlled by the FFW. The information in parentheses 
immediately following the name of each field format identifies the bit position of the 
corresponding software flag in the FFW. See Table 16-1 on page 16-5 for 
descriptions of FFW formats. 


Table 15-7 (Page 1 of 2). Available Field Formats 


Format of Field 


Alphabetic only 
(bits 5-7 = 001) 
Alphabetic shift 
(bits 5—7 = 000) 
Auto enter (bit 8) 


Bypass (bit 2) 


Dup enable (bit 3) 


Field exit required (bit 9) 


I/O (bits 5-7 = 110) 


Katakana shift 
(bits 5—7 = 100) 


Mandatory enter (MD) 
(bit 12) 


Description 


Accepts only characters A—Z (both uppercase and lowercase plus the comma (,), 
period (.), dash (—), and blank characters). Other characters cause operator errors. | 
Some special characters for World Trade countries are also acceptable. 


Accepts all characters, and the Shift keys are acknowledged. 


The contents of all fields, including the modified READ MDT fields, are sent to the 
AS/400 system. The operator begins by pressing one of the field exit keys or by 
entering the last character in last required field. , 


Entries are not allowed in this field. If the workstation operator tries to enter 
something into this field, an error results. 


The 5494 repeats X'1C' from the cursor position to the end of the field when the 
workstation operator presses the Dup key; this displays on the workscreen as an 
overstruck asterisk. 


Requires the workstation operator to exit the field with a nondata key. When the 
operator has entered the last character, the cursor remains under the character and 
blinks, indicating that a Field Exit key is required. 


Only a magnetic stripe reader or selector light pen can enter data into an I/O field 
without causing an error. 


This is the same as the alphabetic shift except that the keyboard is Katakana and is 
placed in Katakana shift. 


Requires the workstation operator to enter something in the file before the 5494 
allows the Enter key to be active. The 5494 recognizes the state of these fields by 
checking the MDT bit for the field. If the workstation operator tries to bypass the field 
using a Field +, Field -, or Field Exit key, an error occurs. 
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Table 15-7 (Page 2 of 2). Available Field Formats 


Format of Field 
Digits only (bits 5—7 = 101) 


Mandatory fill (MF) 
(bits 138-15 = 111) 


Monocase (bit 10) 


No adjust (bits 13-15=000) 


Numeric only 
(bits 5-7 = 011) 


Numeric shift 

(bits 5-7 = 010) 

Right adjust 

(byte 2, bits 13-15: 
e 101 = blank fill 
e 110 = zero fill) 

Signed numeric 

(bits 5—7 = 111) 


15-20 


Functions Reference 


Description 


Allows digits 0—9 only from keyboard. Also allows the Dup key if the Dup enabled bit 
is in the FFW. 


If the operator enters any character into this type of field, the field must be completely 
filled before exiting. Any attempt to leave an unfilled field causes an error. The 
workstation operator can use the Dup key to fill the field. If the field is nulled when 
the workstation operator exits from the first position using the Field Exit or Erase 
Input key and the MDT bit is on, the null characters can be sent back to the AS/400 
system in response to a READ command. 


Regardless of the shift state, the keyboard enters only the uppercase characters A—Z 
in the field. In addition, the following characters on the specified World Trade 
typewriter keyboard are translated to uppercase: 


Austria/Germany uaod 

~ Brazil aceo 
Denmark awa 
Finland aadé 
Norway aweg 
Portugal aco 
Spain n 
Spanish-speaking n 
Sweden aaéo 


For the remaining World Trade typewriter-like and all data-entry keyboards, the 
lowercase special characters are keyed and displayed as lowercase. 


Accepts characters without either position adjustment or insertion of fill characters. 


Accepts only the 0-9, plus (+), comma (,), period (.), and blank (_ ) characters. Any 
other character causes an operator error. The unit position carries the sign digit for 

the field. Use either the Field +, the Field —, or the Field Exit key to exit this field. If 
you use the Field — key to exit the field, the 5494 changes the zone of the low-order 
digit to X'D', unless it is one of the symbols (+, -, . or blank); in this case, an error 

results. 


Accepts all characters. 


Fills all leftmost unoccupied positions of a field with the specified character; 
characters are right-adjust and spaces are blank-filled or zero-filled. The operator 
must specify this as either blank or 0. The fill character appears on the workstation 
screen. 


Allows only characters 0-9. An attempt to enter any other character causes an error. 
The signed numeric field must be at least 2 bytes long. The last (rightmost) position 
is reserved for the sign display (— for negative and blank for positive). You cannot 
type characters into this position. To exit this field, use either the Field +, the Field -, 
or the Field Exit key. If you use the Field — key to exit this field, the 5494 
right-adjusts the field and inserts a negative sign in the rightmost position. If you use 
Field +, the 5494 right-adjusts the field and inserts a blank in the rightmost position. 


If the last character is negative, the zone of the low-order digit is set to X'D' before 
the character is sent to the AS/400 system. If the last character is positive, the 
low-order digit is not changed. The last sign position is not sent to the AS/400 
system in response to either the READ MDT or READ INPUT commands. 


ce el \ 
Ks (OC | 
Nic t/1oO maslt 
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Field Control Word 


Could ple FCW. are clawed ) 


Field.control words (each 2 bytes) are optional and can be included in the SF 
order. When field control words are used, they should follow the FFW of the SF 
order. Any FCW encountered during the modification of an existing format table 
entry is ignored. An FCW of X'FFxx' will not be accepted by the LU. 


Table 15-8 lists all valid FCWs and their corresponding functions. 


Table 15-8. Field Control Words 


FCW Value 
X'80nn' 


X'8101' 
X'8102' 
X'8103' 
X'8106' 
X'8200' 
X'8220' 
X'8240' 


X'8280' or 
X'82C0' 


X'84nn' 
X'8501' 
X'8601 '—X'8603 ' 
X'8680' 
X'88nn' 


X'g89nn' 


X'8Ann' 


X'B140' 
X'B1A0' 


Function 


Entry field resequencing. The nn specifies the next entry field in the 
sequence (X'00' to X'80'). 


Magnetic stripe reader entry field 

Selector light pen or cursor select field 

Magnetic stripe reader and selector light pen entry field 
Selector light pen and selectable attention entry field 
Ideographic-only entry field 

Ideographic data type entry field 

Ideographic-either entry field 

Ideographic-open entry field 


Transparency entry field. The nn can be any two digits. 
Forward edge trigger entry field 

Continued entry field 

Word Wrap entry field 


Cursor progression entry field. The nn is the next entry field in the 
specified application cursor progression sequence. 


Highlighted entry field. The nn specifies the field attribute 


Pointer device selection entry field. If a user selects the entry field, 
the nn specifies the AID to be returned. 


Self-check modulus 11 entry field 
Self-check modulus 10 entry field 


The first FCW of any type is used. Subsequent FCWs of the same type are 
ignored. The 5494 does not check to determine if the FCWs are formatted 
correctly or if the requested function is installed. The 5494 can detect and report 
these errors to the AS/400 system if the FCW is required during subsequent 
command and keystroke processing. 


The following paragraphs explain the types of FCWs. 


Magnetic Stripe Reader (MSR): The MSR allows the reading of numeric 
information encoded on a magnetic stripe card. The card can be encoded with up 
to 128 numeric and control characters. The following requirements must be met 
when specifying a field for MSR input: 


e An FCW must be defined for the field only if operator ID (OID) secured data is 
to be entered into this field. 
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X'8101' identifies an MSR OID secured field. When the MSR OID data is 
read into the field, the 5494 converts the OID code into a colon that 
appears in position 1 of the field to indicate secured data. 


X'8103' allows both the magnetic stripe reader and the selector light pen 
to enter data. 


The MSR data must be entered with the keyboard unlocked or after the System 
Request key sequence is pressed. Otherwise, the data is lost and no error will 
appear to inform the operator of the situation. If the OID is encoded on the 
card, it can only be entered in response to the OID display provided by the 
AS/400 system. 


MSR data can be entered into an I/O field starting at the cursor position. 


The operator must use the cursor movement keys to move the cursor to the 
desired position. 


Data entered from the card must satisfy the requirements of the field selected. 
Any format error can be identified by an appropriate system reference code 
(SRC). 


There can be only one field on each magnetic stripe card. This field can range 
from 1 to 125 characters in length for the IBM 5251 and 5292 display stations. 


No data overflow is allowed. Magnetic stripe data must fit within the selected 
field or the 5494 posts an operator SRC 0034. 


The field starting attribute (nondisplay) must be supplied using the SF order. 


Resequencing: Resequencing allows the 5494 to send the input fields to the 
AS/400 system in any specified order. Resequencing is accomplished by chaining | 
input fields together with FCWs that specify the desired order of transmission. The 
format of the resequencing FCW is as follows: 


Bits Description 

O-1 B'10' 

2-7 B'00O0000' 

8-15 The normal sequence position of the next field to be returned to the AS/400 


system. (The first field on the screen is number 1; the field numbers progress 
sequentially, left to right and top to bottom.) 


Bit 3 of the SOH order contains the number of the field to be sent. If the first field 
identifier in the SOH is set to 0, resequencing does not occur (that is, all 
resequencing FCWs are ignored; fields are sent to the AS/400 system in the order 
defined in the format table). If resequencing does occur, the last field to be sent to 


the 


Bits 


0-1 
2-7 


AS/400 system must contain the following FCW: 
Description 
B'10' 
B'000000 ' 


8-15 B'11111141' 


Functions Reference 


Notes: 


1. If the FCWs create a closed loop, the 5494 detects the error and stops the 
transmission. 


2. An FCW for each field is not required. An FCW pointing to the next sequential 
field is assumed if no resequencing FCW is specified. (The last field in the 
format table must have a resequencing FCW.) 


Selector Light Pen: The selector light pen is a pen-like device that permits the 
operator to select fields of data from the display screen for system input. The ease 
with which the operator can select and designate the correct light pen field is 
affected by the format, content, intensity, and spacing of the light pen fields upon 
the screen. The following requirements must be met when specifying a field for the 
selector light pen: 


e An FCW must be defined for the field. 
X'8102' designates a field that permits selector light pen use. 


X'8103' designates a field that allows the use of both a selector light pen 
and a magnetic stripe reader. 


e Light pen fields on the same line should be separated by at least 4 characters. 
e The light pen field should be formatted as: 

@ ?b*bxx...x@ 

The characters in this field are: 


@ The leading attribute should be high intensity. The trailing attribute 
should be normal intensity. See Table 15-10 on page 15-32 for a list of 
field attributes. 


? A designator character (?) in the first position of the field indicates field 
selection or reselection. This character should change from ? to > after 
selection and back to ? after reselection. 


b A blank should separate the designator character from the rest of the 
field. 
- A target character (*) may be inserted into the field format. This 


character enhances the pen’s ability to detect the field. The pen should 
be aimed at this target character during the selection process. 


xx...x These character combinations indicate a variable length name or 
description of the selectable field. The name should be at least 2 
characters long. 


e The cursor position remains unchanged after a light pen selection is made. 


Ideographic Fields: For information on the ideographic fields, see Appendix A, 
“Ideographic Enhancements.” 


Transparency: A transparency entry defines a field that can contain data of any 
value. The 5494 does not format field data during reprocessing. 


Forward Edge Trigger: Forward edge trigger has the same function as the auto 
enter specified in the field format word. With this FCW, however, the 5494 returns 
a unique forward edge trigger AID code to the AS/400 system when this field is 
exited. 
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Self-Check: The self-check function on the 5494 provides additional integrity for 
the data entry. All field types can be specified for self-checking. The following 
requirements must be met when specifying a field for self-checking: 


e A FCW must be defined for the field. 


X'B1iA0' selects Modulus 10 checking. 
X'B140' selects Modulus 11 checking. 


e Field lengths for checking are restricted to 33 positions. For signed numeric 
fields, only 32 positions can contain digits, and the sign is not checked. If more 
than 33 characters are given, a LUSTAT parameter error results. 


Self-check resolves fields and conditions in the following ways: 


e The function converts nonnumeric characters, including nulls and blanks, by 
_ using the 4 low-order bits from their EBCDIC representation, when the 
low-order bits are in the range O-9; for example: 


A in EBCDIC is C1; therefore A = 1. 
R in EBCDIC is D9; therefore R = 9. 


All other characters with the 4 low-order bits in the range of X'A' through 'F' 
are replaced by 0. For example: % is EBCDIC 6C; therefore % = 0. 


Null and blank characters are also converted to 0. All high-order nulls, zeros, 
and blanks in a field are converted to 0 and do not affect the value of the check 
number. 


e An all-null field checks correctly; this kind of field can result when an operator 
has unsuccessfully tried to enter digits into a field and checking fails, so the 
5494 allows the workstation operator to exit the field from the first positon by 
using the Field Exit key. 


Continued Entry Fields: Continued entry fields are a set of associated entry 
fields that are treated by the 5494 as a single entry field during field data entry and 
editing. 


A continued entry field enables a multiple row entry field to be defined inside of a 
window. Figure 15-2 shows how the eonunues entry fields format can improve 
screen appearance and use. 


Enter Text... 





Figure 15-2. Continued Entry Fields in a Continuous Text Format 


Continued entry fields are defined by Continued Entry Field FCWs, 
(X'8601'—X'8603'). Continued entry fields can also define edit mask entry fields. 


Functions Reference 


Bits O—5 of byte number 2 of the Continued Entry Field FCW are reserved and 
must be set to zero. For bits 6—7 of byte number 2 of the Continued Entry Field 
FCW, specify: 


B'00' Invalid (Causes a negative response) 

B'01' Specifies the first continued field segment 

B'10' Specifies the last continued field segment 

B'11' Specifies the middle continued field segment (all continued entry fields have 
this value specified here). 


As with other entry fields, continued entry fields are defined from the top down and 
from left to right in the data stream, based on the position of the first continued 
entry field segment. All subsequent continued entry field segments must follow one 
another consecutively until the last field segment is specified. These segments are 
also defined from the top down and from left to right. After you complete this task, 
other continued entry fields (and other entry fields) can be defined. 


Continued entry fields are specified in a specific sequence. Consider the following 
rules when specifying continued entry fields: 


e The first field segment in the set must be designated as being first. 
e The last field segment in the set must be designated as being last. 


e All field segments between the first and last must be designated as being in the 
middle. 


e At least two field segments must be defined (first and last). 
e No field segment can span more than one line. 


e If a continued entry field is written within a window, all segments of the 
continued entry field should be written within that window. 


Each continued entry field is presented in the same manner as other entry fields. 
The 5494 creates all continued entry field segments so that they have the same — 
input field characteristics (FFW and optional FCWs). The FFW of the first segment 
is used for all subsequent segments. However, all segments must have a valid 
FFW. 


If the first control character (on a WRITE TO DISPLAY command or on a 
PENDING READ commana) specifies that modified fields are to be nulled, all 
segments of a continued entry field will be nulled if any segment has been modified 
(the MDT is set on). 


FCWs may be used in only the first continued entry field definition (with the 
exception of the continued entry field FCWs associated with each field segment). 


The 5494 sends a negative response if field resequencing is defined for the screen 
display or the first continued entry field segment is defined as: 


e Self-check 

e Right-adjust 

e 1/0 attention 

e Signed numeric 

¢ Mandatory fill 

e Selector light pen (SLP) 

e Magnetic stripe reader (MSR) 
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The 5494 also supports ideographic (double byte character set) continued entry 
fields. The 5494 automatically writes Shift-Out and Shift-In characters on each 
segment when the field is created (Start Field order). It is recommended that the 
host write data to an ideographic continued entry field with a WRITE DATA 
structured field command. (See “WRITE DATA Structured Field” on page 15-93 for 
more information.) 


The 5494 handles each field of the continued entry field set as a single entry field. 
If any of the following type of data is entered or one of the following keys is 
pressed, the 5494 processes the continued entry field as follows: 


Character data In replace mode, there is no unique character data for 
processing. 


When character data is entered in the last character position 
of the first or middle segment of the continued entry field 
set, the cursor moves to the first character position of the 
next segment in the set. When character data is entered in 
the last character position of the last segment of the 
continued entry field set, forward field exit processing is 
started. See the Field Advance description. 


Insert Mode If the display is in insert mode when a character data key is 
pressed, the 5494 responds as follows: 


e If there is no null character specified in the last position 
of the last segment, an error message is displayed. 


e Field data characters following the current cursor 
position are shifted one position. Each field data 
character in the last character position of the current 
and remaining segments (except the last segment) is 
shifted to the first character position of the following 
field. 


e The field data character that is entered is written at the 
cursor position. 


e The cursor advances to the next cursor position. 


Delete lf the Delete key is pressed within a continued entry field, 
the 5494 responds as follows: 


e All field data within the continued entry segment (that 
follows the current cursor position) is shifted toward the 
cursor position. Each data character in the first 
character position of the remaining segments is shifted 
to the last character position of the preceding segment. 


¢ A null character is placed in the last character position 
of the last segment. 


Field Exit lf the Field Exit key is pressed within a continued entry field, 
the 5494 responds as follows: 


¢ All field data that follows the current cursor position is 
nulled. | 


e Forward field exit processing is started (see Field 
Advance description). 
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Field Plus The 5494 processes this key the same way it processes the 


Field Exit key. 

Field Minus This key is not valid. If it is used, an error message is 
displayed. 

Field Advance The Field Advance key starts forward field exit processing. 


Field Backspace The Field Backspace key starts backward field exit 
processing. When backward field exit processing occurs, 
the cursor moves to the previous non-bypass field. The 
previous non-bypass field is determined by exiting the first 
continued entry field segment (which is independent of the 
segment containing the cursor). 


Duplicate (Dup) Key All characters within the continued entry field set following 
the current cursor location are set to the Dup character. 


Forward Field Exit Processing 
If a continued entry field set is specified as either automatic 
enter or forward-edge trigger, automatic enter or 
forward-edge trigger processing is started for the last 
position of the last field segment. 


lf cursor progression is specified on the first continued entry 
field segment, the cursor moves to the cursor progression 
target field whenever you exit any of the continued entry 
field segments. Otherwise, the cursor returns to the next 
non-bypass field when the Field Advance Exit key is 
pressed (which skips over subsequent field segments of the 
continued entry field). The next non-bypass field is 
determined by exiting the first continued entry field segment 
(which is independent of the segment containing the cursor). 


The continued entry field is treated as a single input field. If the AS/400 system 
sets the MDT flag in the first continued entry field segment, or if the user has 
modified any continued entry field segment, the MDT flags of all continued entry 
field segments that make up the continued entry field are set. Therefore, data from 
the entire continued entry field set is to be sent inbound in response to the READ 
MDT command. There are no delimiters (SBA orders) separating the data from 
each of the continued entry field segments. In response to the READ MDT 
command, trailing null characters are not returned after the last non-null character 
in the field data set. 


For inbound data from an ideographic continued entry field, the 5494 removes extra 
Shift-Out characters (which start each middle and last segment) and Shift-In 
characters (which end each first and middle segment). For a READ MDT 
command from an Ideographic Only or Ideographic Either entry field, the 5494 
removes trailing nulls before the last Shift-In. For a READ INPUT command, the 
inbound data must be the exact length of the entry field; therefore, the 5494 pads 
the inbound data with trailing nulls as required. These padded nulls should be 
removed by the host before writing the field data back to the field using the WRITE 
DATA structured field. 


Edit Mask Entry Field: An edit mask entry field can be created by defining a 


continued field segment for each input-capable part of the edit mask field. For 
example, Figure 15-3 on page 15-28 shows two edit mask entry fields. 
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Telephone Number .. . (800)555-1212 


Social Security Number . . 


Figure 15-3. Edit Mask Entry Fields 


In Figure 15-3, the three hyphens (-) and the parentheses (__‘+) are protected 
positions. The fields from this figure are defined as follows: 


Each input-capable portion of the edit mask entry field is defined as a 
continued field segment. In Figure 15-3, there are three continued field 
segments in each field. In the first field, the continued field segments are 
separated by a right parenthesis and a hyphen. In the second field, the 
continued field segments are separated by two hyphens. When creating edit 
mask entry fields, there must be at least two continued field segments. 


The mask characters are written over the field attributes using an additional set 
buffer address (SBA) and the actual character in the following command. For 
the telephone number entry field, a display attribute must be written to the left 
of the left parenthesis since the field attribute is overwritten by the left 
parenthesis. 


Notes: 


1. 


lf an edit mask entry field is redefined when the entry field is active on the 
display screen (and the AS/400 application user redefines the edit mask entry 
field in order to change the leading field attribute or FFW), the mask characters 
must be rewritten after each edit mask entry field has been redefined. 


. You can highlight edit mask entry fields, but it is not recommended. In the 


case of the telephone number edit mask entry field, highlighting is ignored 
because the attribute position is overwritten by the left mask character 
parenthesis. In the case of the social security number edit mask entry field, if 
the user moves the cursor under a mask character, highlighting is not 
recognized by the system (highlighting would appear to flash on and off as the 
user moves the cursor left or right on the highlighted edit mask entry field). 


Word Wrap Entry Fields: Entry fields may have word wrap specified. Word wrap 
prevents words from splitting between lines of a field that span lines, or between 
segments of a continued entry field. Word wrap makes viewing of field data easier 
because words are not partly on one line or field segment, and partly on the next. 


In order to prevent usability problems, the following recommendations should be 
followed: 


Functions Reference 


The total entry field length should take into account that word wrap is used. 
Character positions at the ends of lines or segments may be used for padding 
when a wrap occurs. If a field is too short, the 5494 may turn off word wrap in 
order to fit the data within the field. 


The length of each line or segment should be larger than the longest word that 
would be entered in the field. If a line or segment is too short, insert failed 
operator errors (0012) could result or the data may be shifted down to the last 
line or segment by the 5494. 


Word Wrap Entry Fields—Host Interface: Word wrap is defined by the word wrap 
FCW (X'8680'). 


To write data to a word wrap field, the Write Data Structured Field order must be 
used, or an equivalent algorithm implemented in the host (see page 15-93 for 
details). The Write Data Structured Field order ensures that words are not split 
between two segments or lines of word wrap fields. If all the data in the Write Data 
Structured Field order cannot fit within a word wrap field without splitting words, the 
word wrap function for that field is not used, and the data is rewritten as if word 
wrap had not been specified. Note that word wrap could be used again if the user 
were to change the field data such that the data would fit using word wrap (for 
example, the user deletes some characters). 


If word wrap is specified for an entry field that is contained on a single line, word 
wrap is allowed. Editing behavior operates as described below, except that words 
are never spilled. 


Word wrap is ignored for ideographic only fields, ideographic pure fields, and 
ideographic either fields (with double byte). In ideographic open fields, word wrap 
only applies to the single byte data. 


The 5494 will return a negative response if a word wrap field is defined along with 
any of the following field types or features: 


e Signed numeric (FFW) 

e Numeric only (FFW) 

e Digits only (FFW) 

e Right-adjust (FFW) 

e Mandatory fill (FFW) 

e Magnetic stripe reader (FCW) 

e Selector light pen (FCW) 

e Selectable attention (FCW) 

e Self-check (FCW) 

e Dup allowed (FFW) 

e For an ideographic open field with word wrap specified that spans lines, each 
portion of the field on each line must be at least 4 bytes long. 


The keyboard functions within the word wrap field are described as follows: 


Replacing Data In replace mode, a character may cause two words to 
become one (if a non-blank replaces a blank between two 
non-blank words), or it may extend a word (by adding to the 
end of it). In these cases, if the new character causes a 
word to be split between two lines or segments, the newly 
formed word is inserted into the next line or segment. The 
space vacated on the first line or segment is filled with nulls. 
If data will no longer fit into a word wrap field as a result of 
words spilling, the field data is rewritten to the field as if 
word wrap were not specified. Note that word wrap could 
be used again if the user were to change the field data such 
that the data would fit using word wrap (for example, the 
user deletes some characters). ; 


Inserting Data In insert mode, a character may also cause words to no 
longer fit on lines or segments. In this case, any non-fitting 
word is spilled to the following line. During this process, 
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imbedded nulls may be removed. If the data will not fit back 
into the field, the data is written as without word wrap in 
effect. Note that word wrap could be used again if the user 
were to change the field data such that the data would fit 
using word wrap. If the data still will not fit back into the 
field, operator error 0012 is posted. 


Deleting Data _ Imbedded nulls may be removed as a result of the Delete 
key. 


Erase End of Field __|n addition to its normal processing, this key causes the 
data in word wrap fields to be reformatted. For example, if 
a word at the start of a segment is shortened by this 
process, it may fit in the previous segment. Additionally, if 
word wrap had been turned off because the entry field was 
full, the removal of data may allow word wrap to be turned 


on again. 
Field Exit Same processing as Erase End of Field 
Field Plus Same processing as Erase End of Field 


Reverse Key The Reverse key is not allowed in word wrap fields. 
Operator error 0091 is posted. 


ASD Processing For Arabic and Farsi, Automatic Shape Determination 
precludes the word wrap function. Word wrapping will not 
occur when the cursor direction is right-to-left for these 
languages. 


Word Wrap Fields—Iinbound Field Data: The 5494 removes all single byte nulls 
from the inbound data. If the entry field is a right-to-left entry field, data is returned 
starting at the right-most position. 


Note: Write Data command processing into a right-to-left entry field is consistent 
with inbound data from a right-to-left Word Wrap field; the AS/400 system does not 
need to reverse the entry field data. 


Inbound Data from a READ MDT Command: Trailing nulls at the end of. the 
field are not returned in the inbound data. 


Inbound Data from a READ INPUT Command: Entry field data returned from 
a READ INPUT command must be exactly the length of the entry field. 
Therefore, the 5494 pads the inbound data for the entry field with trailing nulls, 
if necessary. These padded nulls should be removed by the host before 
resending the entry field data to the 5494 using a Write Data structured field. 


Cursor Progression Entry Field: Cursor Progression fields are defined by the 
Cursor Progression FCW (X'88nn'), where X'nn' specifies the cursor progression 
field. It is the number of the entry field to which the cursor will be moved when a 
forward field exit occurs. Remember that all entry fields on the display are 
presented from top to bottom and left to right for each new row, which starts at field 
number 1 (including bypass entry fields). 


Continued entry fields and selection entry fields count as a single field. Scroll bar 
fields are not counted. 


If you have defined a display to use read resequencing (defined in the SOH order), 
the 5494 ignores cursor progression FCWs. Read resequencing and cursor 
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progression cannot be used together on the same display screen. The 5494 
ignores the cursor progression field number X'00' and any field number of an 
undefined field. 


If a backward field exit occurs within a non-bypass entry field, and the display 
screen contains cursor progression fields, the 5494 will scan for a cursor 
progression FCW that is targeting the entry field or selection field that is being 
exited. If a cursor progression FCW is found, the cursor is moved to the entry field 
associated with it. 


Highlighted Entry Field: Highlighted entry fields are defined by a 
X'8900'—-X'89FF' FCW. 


When the cursor is in a highlighted field, the leading field attribute is changed to the 
specified attribute. The field can be any type of entry field. Continued entry fields 
can be defined as highlighted fields (the highlighted FCW is sent only on the first 
segment); and the 5494 will replace each leading segment field attribute with the 
specified attribute when the cursor enters any of the segments. 


Table 15-9 defines the bytes of the highlighted entry field FCW 
(X'8900'—X'89FF'). 


Table 15-9. Definitions for the Highlighted Entry Field FCW (X'8900'-X'89FF') 


Byte Field Value Description 
Byte 1 X'89' 
Byte 2 Bits 0-1 B'00' Applies to both monochrome and color displays. 
B'01' Applies to monochrome displays only. The 5494 ignores 


the FCW on a color display. If a different hex attribute on 
monochrome or color displays is desired, two highlighting 
FCWs can be sent. 


B'10' Applies to color displays only. The 5494 ignores the FCW 
on a monochrome display. 
B'i1' Reserved. FCW is ignored. 
Byte 2 Bit 2 B'0' The text cursor is visible within the field. 
B'1' The text cursor is invisible when it enters the field. The 


field must be an I/O field (with no MSR, LP, or 1/O 
attention FCW). 


Byte 2 Bits 3-7 Defines the lower five bits of the attribute to be used when 
the cursor enters the field, (X'00'-X'1F'). The 5494 will 
specify the OR operand with X'20' to produce the proper 
attributes. 


Notes: 


1. A highlighted entry field FCW is ignored for a bypass field and a row 1, column 
1 field (actually defined at row 1, column 0). | 


2. If a field has an invisible text cursor, and the field is not an I/O field, the 
highlighting entry field FCW is ignored. 


3. If an I/O field has an invisible text cursor, the field must not have an LP, MSR, 
or I/O attention FCW, otherwise the highlighting FCW is ignored. 


4. \/O fields normally enable the user to use specific keys to modify entry field 
data (for example, Field Exit and Erase EOF keys). However, if an I/O field 
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has no LP, MSR, or I/O attention FCW, but it does have a highlighting entry 
field FCW, the entry field data is not able to be modified. 


5. A highlighted entry field can have an invisible text cursor. If this is the case, 
the first field position is returned in the inbound data. 


6. Whenever the cursor enters a highlighted entry field, the leading field attribute 
is changed to the specified attribute. When the cursor exits the field, the 
Original field attribute is restored. 


Mouse Selection Entry Field: Mouse selection fields are defined by a X'8Ann' 
FCW where nn is the AID to be returned in the inbound data when a user selects 
this non-bypass field. The AID value should be a currently defined AID or be 
between the values X'70'—X'7F'. See Table 16-1 on page 16-5. 


The mouse selection entry field enables the user to use a pointing device when 
selecting values for a field. When a user selects a position on a mouse selection 
field, the text cursor is moved to the location of the mouse cursor, the keyboard is 
locked, and the specified AID is returned. 


The AID specified in the mouse selection entry field FCW is returned to the AS/400 
system. Field data can be included in the inbound data, depending on the type of 
AID. AID values such as Enter and Roll Up return inbound data. 


Field Attributes 

The field attributes control the image produced on the workstation screen. Each 
attribute occupies one character position in the workstation regeneration buffer and 
is displayed as a blank. The effect produced by an attribute begins at its location in 
the regeneration buffer and continues until the next attribute appears. 


The attributes for non-color and color displays are shown in Table 15-10. 


Table 15-10 (Page 17 of 2). Field Attributes in the SF 


The attributes for a non-color display are specified as follows: 


Bit 0-2 0 0 1 = Attribute identification flag 
Bit 3 O = Column separator off | 
1 = Column separator on 
Bit 4 0 = Do not blink field 
1 = Blink field 
Bit 5 0 = Do not underscore field 
1 = Underscore field 
Bit 6 0 = Low intensity 
1 = High intensity 
Bit 7 0 = Normal image 


1 = Reverse image 


Note: Multiple functions can be selected. If bits 5, 6, and 7 all = 1, displaying of field will 
be inhibited. | 


The attributes for a color display are specified as follows: 


X'20' Green 

X'21' Green/Reverse image 
X22! White 

X'23' White/Reverse image 
X'24'- Green/Underscore 


Functions Reference 
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X'25' Green/Underscore/Reverse image 
X'26' White/Underscore 

X'27' Nondisplay 

X'28' Red 

X'29' Red/Reverse image 

X'2A' Red/Blink 

X'2B' Red/Reverse image/Blink 

X'2C' Red/Underscore 

X'2D' Red/Underscore/Reverse image 
X'2E' Red/Underscore/Blink 

X'2F' Nondisplay 

X'30' Turquoise/Column separators 

X'31! Turquoise/Column separators/Reverse image 
X'32! Yellow/Column separators 

X'33' Yellow/Column separators/Reverse image 
X'34' Turquoise/Underscore 

X'35' Turquoise/Underscore/Reverse image 
X'36' Yellow/Underscore 

X'37' Nondisplay 

X'38' Pink 

X'39' Pink/Reverse image 

X'3A' Blue 

X'3B! Blue/Reverse image 

X'3C' Pink/Underscore 

X'3D! Pink/Underscore/Reverse image 
X'SE! Blue/Underscore 

X'3F! Nondisplay 


Field Length 


The length of each field is controlled by a 2-byte field immediately following the 
attribute character. The field length specifies the number of keying positions for the 
input field, not including the starting and ending attribute. Limitations on this field 


are: 


e Alphabetic fields must be at least 1 character long. | 
e Signed numeric fields can be at least 2 characters long. 
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The WRITE TO DISPLAY Structured Field (WDSF) order enables structured fields 
to be used in a WRITE TO DISPLAY command. The maximum length of a 

structured field which follows a WDSF is 8191 bytes. The order code is X'15'. A 
single structured field must come after the WDSF order, which is shown as follows: 


WTD ORDERS 
COMMAND 


AND DATA 
X11! 


STRUCTURED ORDERS 
FIELD AND DATA 





Because there is a significant amount of information describing the WDSF order, 
Table 15-11 is provided to help you understand some of the major functions and 
commands that are included in the WDSF order, and where you can locate them in 
this chapter. The WDSF order functions and commands are not listed in the order 
that they appear in this chapter, they are listed by byte type. The far right column 
of the table directs you to the location where the information about the function or 


command can be found. 


Table 15-11. Write to Display Structured Field Order Structured Fields 


Structured Field 
DEFINE SELECTION FIELD 
CREATE WINDOW 


Type 
X'50! 
X'51! 


Location 
Page 15-46 
Page 15-34 


UNRESTRICTED WINDOW CURSOR 


MOVEMENT 


WRITE DATA 


REMOVE GUI SELECTION FIELD 
REMOVE GUI WINDOW 

REMOVE GUI SCROLL BAR FIELD 
REMOVE ALL GUI CONSTRUCTS 
DRAW/ERASE GRID LINES 
CLEAR GRID LINE BUFFER 


X'52! 


X'53' 
X'54! 
X'55' 
X'58' 
X'59! 
X'5B' 
X'5F' 
X'60! 
X'61! 


CREATE WINDOW Structured Field 
Use the CREATE WINDOW structured field to create a window on the display 
screen. With this command, the 5494 can draw a window border and clear a 


window area. 


Page 15-42 


Page 15-88 
Page 15-93 | 


DEFINE SCROLL BAR FIELD 


PROGRAMMABLE MOUSE BUTTONS 


Page 15-95 
Page 15-87 
Page 15-42 
Page 15-92 
Page 15-43 
Page 15-99 
Page 15-102 


On a PWS, a window can be a GUI construct, and the CREATE WINDOW 


structured field has the following effect: 


e The window GUI construct covers screen data. You may not simply write data 
over a window border, for example, with an SBA order followed by data to 


remove a GUI construct. 


Use one of the following commands to remove a GUI window created by the 


CREATE WINDOW structured field: 


— RESTORE command 


Functions Reference 


RESTORE PARTIAL SCREEN command 

CLEAR UNIT command 

— CLEAR UNIT ALTERNATE command 

— REMOVE GUI WINDOW structured field 

— REMOVE ALL GUI CONSTRUCTS structured field. 


¢ The PWS determines whether to write data to the base display screen or into a 
GUI window (there can be multiple GUI windows on the display screen). The 
PWS does not support an SBA order that writes data characters to both the 
base display screen and the window. You can write to one or the other, but 
not both. 


e If you want to create another window that partially overlaps a window that you 
just created, use the CREATE WINDOW structured field again rather than 
specifying an SBA order followed by data characters. Exceeding the 128 
window limit on a single screen causes a 1005013E negative response to be 
returned. A window written to the same location as a previous window and of 
the same size as the previous window will overwrite the previous window. 
(PWS frees memory associated with the window.) 


Your window position is relative to the top row, left corner attribute. See 
Figure 15-4 and Figure 15-7 on page 15-40. The window position is also 
determined by the current display address (typically set with an SBA order). 


A pull-down window is positioned as if the top row, left corner attribute was actually 
written. 


Writes to the window are still addressed according to actual location on the display 
screen. The current display address is not modified as a result of a CREATE 
WINDOW structured field. A window should not be written over active fields (that 
is, entry, selection, or scroll bar). 


If you want to print a screen image on hardcopy, the AS/400 application user may 
choose to use the READ SCREEN TO PRINT command. See “READ SCREEN 
TO PRINT Command” on page 15-109. 


The CREATE WINDOW structured field must follow the WRITE TO DISPLAY 
STRUCTURED FIELD order. 


Table 15-12 (Page 1 of 2). Format for Create Window Structured Field Major Structure 


Byte Name Value Description 
1-2 Major | >8 Length of structured field in bytes (including 
Length length bytes) 
Class X'D9' 5250 class of structured field 
Type X'51' Create window structured field type 
Flag Byte 1 Bit O Cursor restricted to window if set to on 
Bit 1 Window is a pull-down menu bar if set to on - 
Bits 2-7 Reserved (must be set to off) 


Flag Byte 2 Bits 0-7 Reserved (must be set to off) 


Reserved X'00! Reserved 
8 Window 1-25 Number of screen rows inside the window 
Depth 
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Table 15-12 (Page 2 of 2). Format for Create Window Structured Field Major Structure 


Byte Name Value Description | 

9 Window 1-126 Number of screen columns inside the window 
Width 

10—n Minor Optional minor structures 
Structures 


CREATE WINDOW Major Structure Parameters 


Functions Reference 


Restrict Cursor: If this parameter is set, cursor movement is restricted to 
within the window. Cursor movement processing within the window is similar to 
cursor movement processing on a display screen. Unpredictable cursor 
movement occurs if fields that accept the cursor or the cursor home address 
are defined outside of the window and restricted cursor movement is set to on. 


Cursor movement is not restricted if any of the following commands are sent: 
¢ RESTORE command | 
¢ RESTORE PARTIAL SCREEN command 
e CLEAR UNIT command 
e CLEAR UNIT ALTERNATE command 


¢ REMOVE GUI! WINDOW structured field (removing last window that was 
written) | 


e REMOVE ALL GUI CONSTRUCTS structured field 
e UNRESTRICTED WINDOW CURSOR MOVEMENT structured field 
¢ CREATE WINDOW structured field (another one). 


Pull-Down Window: If this parameter is set, this window is a pull-down menu. 
Pull-down menus have the following qualities to consider: 


° Some PWSs will not create a normal window border when other 
highlighting values are used, for example, background color. 


e Only the corner characters on the top row are written. The remaining 
window border is not affected by this parameter. If displays that support 
window border characters also support a “T” character, the “T” character is 
written to the top corners, as in Figure 15-7 on page 15-40. Otherwise, 
the vertical line character is written. | 


¢ When this parameter is specified, the selection field that defines the | 
pull-down menu should indicate that the selection field is a pull-down menu. 


Window Depth: If this parameter is used, it indicates the number of rows 
within the window. The minimum window depth value is 1. The maximum 
window depth value is the number of rows remaining on the window minus 1 
(for the bottom border row). 


Window Width: If this parameter is used, it indicates the number of columns 
within the window. The minimum window width value is 1. The maximum 
window width value is the number of columns remaining on the window on the 
right minus 3 (for the right border). 


Border Presentation Minor Structure: This minor structure is optional. If this 
minor structure is not specified, the default border presentation is used, based on 
the capabilities for a given display. See “Default Border Attribute and Characters” 
on page 15-40 for a description of default characters and attributes. 


lf the border presentation minor structure is used, it must be the first minor 
structure following the CREATE WINDOW structured field major structure. 


Table 15-13 describes the format for the border presentation minor structure. 


Table 15-13. Format for Border Presentation Minor Structure 


Byte 
P 


10 


11 


12 


13 


Name 


Minor 
Length 


Type 
Flags 


Monochrome 
Border 
Attribute 


Color - 
Border 
Attribute 


Upper Left 
Border 
Character 


Top Border 
Character 


Upper Right 
Border 
Character 


Left Border 
Character 


| Right | 


Border 
Character 


Lower Left 
Border 
Character 


Bottom 
Border 
Character 


Lower Right 
Border 
Character 


Value 
4-13 


X'01' 
Bit O 


Bits 1—7 


X'00' or 
X'20'-X'3F! 


X'00' or 
X'20'-X'3F' 


X'00' or 
X'01'-X'FE! 


X'00' or 
X'01'—X'FE' 
X'0O0O' or 
X'01'—X'FE' 


X'00' or 
X'01'—X' FE! 
X'00' or 
X'01'-X'FE! 


-X'00! or 


X'01'—-X'FE! 


X'00' or 
X'01'-X'FE! 


X'00' or 
X'01'-X'FE! 


Description 


Minor structure length (including length byte) 
Border presentation minor structure type 


Use Border presentation characters on a 
GUI-like NWS if set to on 


Reserved (must be set to off) 
Display attribute to be used for window border 
presentation on a monochrome display. 


Display attribute to be used for window border 
presentation on a color display. 


Character to be used for upper left corner. 


Character to be used for top border. 


Character to be used for upper right corner. 


Character to be used for left border. 


Character to be used for right border. 


Character to be used for lower left corner. 


Character to be used for bottom border. 


Character to be used for lower right corner. 


lf a PWS has GUI capabilities, the PWS can ignore the border presentation 
characters that were specified and use GUI borders and attributes instead. 


Chapter 15. Display Data Streams 15-37 


A value of X'00' in any of bytes 4—13 indicates that the default attribute or border 
character is used. 


A display attribute that is not valid is ignored by the 5494, and the default display 
attribute is used. 


Create Window Title/Footer Minor Structure: 


This minor structure is optional, 


but it should be used if you want a title in the top window border. On a PWS, this 
minor structure must be used to integrate the text title into the window border. This 
minor structure is ignored for pull-down windows. 


Table 15-14 describes the format for the window title/footer minor structure. 


Table 15-14. Format for Window Title/Footer Minor Structure 


Byte 
1 


Name 


Minor 
Length 


Type 
Flags 


Monochrome 
Title/Footer 
Attribute 


Color 
Title/Footer 
Attribute 


Reserved | 
Title Text 


Value 
>6 


X'10' 
Bits O—1 


Bit 2 


Bits 3-7 


X'0O' or 
X'20'—X'3F' 


X'00' or 
X'20'-X'3F' 


X'00' 


Description 


Minor structure length (including length byte) 


Window title/footer minor structure type 
Orientation 


X'00' = Window title or footer is centered. 
X'01' = Window title or footer is right justified. 
X'10' = Window title or footer is left justified. 
X'11' = Reserved (title or footer is centered) 


X'O' = Window title is defined. 
X'1' = Window footer is defined. 


Reserved (must be set to off) 


Display attribute to precede the title or footer on 
a monochrome display. 


Display attribute to precede the title or footer on 
a color display. 


Reserved 


The window title text is written to the top border 
of the window. The window footer text is 
written to the bottom border. (For more 
information, see “How the 5494 Processes the 
CREATE WINDOW Structured Field” on 

page 15-39.) If the title or footer text is too 
long to fit in the window border, the text is 
truncated. The text should be less than or 
equal to the window width, unless the text is 
centered and attributes are not written. In this 
instance, window width + 2 characters may be 
written. Title text for a pull-down window is 
ignored, but footer text may be used. If botha 
title and a footer are desired for the same 
window, two Window Title/Footer minor 
structures are required. 


If the specified attribute parameter (for a color or monochrome display) corresponds | 
to a valid display attribute, the 5494 places the specified attribute immediately in 
front of the title or footer text and places the window border attribute immediately 
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after the title or footer text. If the display attribute is X'0O' or not valid, no attribute 
is written and the title or footer text will have the same attribute effect as the 
window border. 


How the 5494 Processes the CREATE WINDOW Structured Field: When the 
CREATE WINDOW structured field is received by the 5494, the 5494 performs the 
following tasks: 


e Creates the window borders 
e Clears the window area (including the display screen and active extended 
attribute planes). 


The AS/400 application is responsible for ensuring that all entry fields and data 
defined in the window do not extend beyond the window borders. However, the 
exceptions are: 


e A leading attribute (input or output data beginning with a display attribute) can 
overwrite the second left border attribute. 


e An ending field attribute can overlap the first right border attribute. The 5494 
suppresses an ending field attribute (SF order) if the ending attribute overlaps 
exactly the first attribute on the right border. 


e The 5494 suppresses the trailing attributes of a scroll bar field if the attributes 
overlap exactly. 


e The 5494 suppresses trailing attributes of a selection field if the attributes 
overlap exactly. The 5494 only keeps track of the right window border for the 
last CREATE WINDOW structured field that was specified. 


Figure 15-4 through Figure 15-7 on page 15-40 show examples of 5494-generated 
windows. For all the examples: 
@ Display attribute 


Colon (:) and Period (.) Default border characters 


Figure 15-4 shows the default format of a 5494-generated window. 


CRE ee ar errr Ele Vee send eas @ 
@:@ @:@ 
@:@ —6:@ 
@:@ @:@ 
@:@ @:@ 
@:@ Q:@ 
@:@ @:@ 
Oe rset Buia eae win ean tos :@ 


Figure 15-4. Default Format of a 5494-Generated Window 
Figure 15-5 on page 15-40 shows the format of a 5494-generated window with an 


optional left-justified window title and optional right-justified window footer, both with 
attributes. 
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Oes pcceuvhs-t asia. @footer@:@ 
Figure 15-5. 5494-Generated Window With a Window Title and Footer 


QDQ|AD @D DBD © 
QDQqAD @ @ @ 


Figure 15-6 shows the format of a 5494-generated window with an optional 
left-justified window title without attributes and an optional right-justified window 
footer without attributes. 


O01 Ul Ovestoteucusiescse te 
@:@ @:@ 
@:@ @:@ 
@:@ @:@ 
@:@ @:@ 
@:@ @:@ 
@:@ @:@ 
O85 5 oreacanet ane se as footer. :@ 


Figure 15-6. 5494-Generated Window With Title and Footer 


Figure 15-7 shows the format of a 5494-generated pull-down window with an 
optional centered footer. | 


Figure 15-7. 5494-Generated Pull-Down Window With Optional Centered Footer 


Note: Only the corner characters are created on the top window row. (When a 

menu bar is created, a separator line is drawn below the menu bar. This separator 
line corresponds to the top window row.) Positioning of the window is based on the | 
current display address, as if the leftmost attribute were written on the top row. 


Default Border Attribute and Characters The following default window border 
attribute is: 

Normal display (X'20') For monochrome displays 

Blue (X'3A') For color displays. 


You can use the border presentation minor structure to change border attribute 
settings. 


The default border characters for 5250 displays are as follows: 


Period (.) | Upper left corner 
Period (.) | Top border character 
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Period (.) | Upper right corner 
Colon (:) Left border character 
Colon (:) Right border character 
Colon (:) Lower left corner 

Period (.) Bottom border character 
Colon (:) Bottom right corner 


Some NWSs, such as the InfoWindow II displays, can create more advanced 
border characters, for example, drawing a box around the window. The border is 
made up of GUIl-like characters. The GUl-like characters are the default characters 
on these NWS. 


Left Border Attributes: The first display attribute in the left border of the 
window is the left border attribute, which is used to create the highlighting and 
border color. 


The 5494 sets the second display attribute in the left window border to normal 
intensity (X'20') to terminate highlighting and the window color. This causes 
the window contents to be green on color displays. The second display 
attribute can be changed after the CREATE WINDOW structured field has been 
issued, but it should be an attribute to terminate highlighting and the border 
color. 


Right Border Attributes: The first display attribute in the right border of the 
window is the right border attribute, which is used to create highlighting and the 
border color. The right border attribute is set to the same value as the left 
border attribute. 


The 5494 uses the second display attribute in the right window border to retain 
color and highlighting effects in the underlying window area. The 5494 scans 
the underlying window contents for display attributes to determine what the 
display attribute value should be. 


lf extended attributes (other than ideographic) are used on the screen, the 5494 
clears the extended attribute plane behind the window and creates normal 
extended attributes on the left side of the plane behind the window. The 5494 
does not scan for extended attributes to determine a right border extended 
attribute. Extended attributes are used behind the display screen and do not 
take a screen position. 


The 5494 assumes that there are no ideographic extended attributes between 
display screen Shift-out or Shift-in pairs. Similarly, the 5494 assumes that there 
are no display screen Shift-out or Shift-in characters between ideographic 
extended Shift-out or Shift-in attribute pairs. If there are any ideographic 
extended attributes on the display screen, the 5494 generates ideographic 
extended Shift-in attributes as required in the left border and ideographic 
extended Shift-out attributes as required in the right border.. 


lf there are ideographic characters in the underlying window area, the 5494 
generates Shift-in control characters as required for the left border and Shift-out 
control characters as required for the right border. The 5494 will add blanks 
(as needed) to maintain proper byte alignment. 


You can create multiple levels of windows. The AS/400 application restores the 
display screen as windows are removed. 


The format of inbound window field data is the same as inbound data from the 
base window. 
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UNRESTRICTED WINDOW CURSOR MOVEMENT Structured Field 


You can use this structured field to obtain unrestricted cursor movement. The 
cursor movement may be restricted in the CREATE WINDOW structured field. The 
structured field of the UNRESTRICTED WINDOW CURSOR MOVEMENT 
structured field must follow a WDSF order. | 


Table 15-15 describes the format for the unrestricted window cursor movement 
major structure. 


Table 15-15. Format for Unrestricted Window Cursor Movement Major Structure 


Byte Name Value Description 
1-2 Major Length 6 Length of structured field in bytes (including 
length bytes) 
Class X'D9g' 5250 class structured field 
Type X'52' Unrestricted window cursor movement 
structured field type 
Flag byte 1 Bits 0-7 Reserved (must be set to off) 
Reserved X'00' Reserved 


REMOVE GUI WINDOW Structured Field 
It is recommended that you use this structured field with caution. The REMOVE 
GUI WINDOW structured field can be used to terminate a GUI window construct. 


For a PWS, a window created by the CREATE WINDOW structured field can be a 
GUI construct. The 5494 performs limited processing for this structured field. 


When using the REMOVE GU! WINDOW structured field, the current display 
address must be the same as the address used when the window was created by a 
CREATE WINDOW structured field. The 5494 attempts to find a match (current 
display address and a GUI window). When a match is found, the GUI construct is 
removed, but the display screen is not cleared. 


If the current display address matches the address of the top window (the most 
recent window created on the display), the 5494 performs the following screen 
actions: 


¢ Cursor movement is unrestricted (if cursor movement was restricted when the 
window was created). 


e The 5494 no longer keeps track of the right window border, and no longer 
suppresses trailing field attributes, selection field ending choice text attributes, 
or ending scroll bar attributes. 


It is recommended that a PWS send data to both the GUI window construct and to 
the display screen. When this is done and the REMOVE GUI WINDOW command 
is issued, the NWS display screen and the PWS display screen will be similar 
(screen data can then be overwritten). 


If a GUI window construct has a GUI selection field or GUI scroll bar field in the 
window, GUI constructs are also deleted when a GUI window is removed. 
Therefore, it is important to issue a CLEAR FORMAT command or SOH order after 
the REMOVE GUI WINDOW structured field in the same display data stream. 


Functions Reference 


The structured field of the REMOVE GUI WINDOW structured field must follow a 
WDSF order. 


Table 15-16 describes the format for the remove GUI window major structure. 


Table 15-16. Format for Remove GUI Window Major Structure 


Byte Name Value Description 
1-2 Major 7 Length of structured field in bytes (including 
Length length bytes) 
Class X'D9' 5250 class structured field 
4 Type X'59' Remove GUI Window structured field type 
5 Flag Byte 1 Bit O Reserved (must be set to off) 
Bit 1 Window was a menu bar pull down if set to on 
Bits 2-7 Reserved (must be set to off) 
6 Flag Byte 2 Bits 0-7 Reserved (must be set to off) 
7 Reserved X'00' Reserved 


The pull-down window parameter must be specified in the same manner that it was 
when the window was created by the CREATE WINDOW structured field; 
otherwise, the REMOVE GUI WINDOW structured field is ignored. 


REMOVE ALL GUI CONSTRUCTS Structured Field 


It is recommended that you use this structured field with caution. The REMOVE 
GUI CONSTRUCTS structured field can be used to terminate all GUI constructs on 
the display screen. 


For a PWS, GUI constructs can be windows, selection fields, and scroll bars. The 
5494 performs limited processing for this command. 


When this structured field is issued, the 5494 and PWS: 


e Process all of the functions of a REMOVE GUI WINDOW structured field 
against all of the GUI windows on the display screen (see page 15-42). 


e Process all of the functions of a REMOVE GUI SELECTION FIELD structured 
field against all of the GUI selection fields on the display screen (see page 
15-87). 

e Process all of the functions of a REMOVE GUI SCROLL BAR FIELD structured 


field against all of the GUI selection fields on the display screen (see page 
15-92). 


If there is a GUI selection field or a GUI scroll bar field on the display screen, these 
GUI constructs are deleted by this command. Therefore, it is important to issue a 
CLEAR FORMAT command or SOH order after the REMOVE ALL GUI 
CONSTRUCTS structured field in the same display data stream. 


The structured field of the REMOVE ALL GUI CONSTRUCTS structured field must 
follow the WDSF order. 


Table 15-17 on page 15-44 describes the format for the remove all GUI constructs 
major structure. 
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Table 15-17. Format for Remove All GUI Constructs Major Structure 


Byte Name Value | Description | 
1-2 Major 7 Length of structured field in bytes (including 
Length length bytes) 
3 Class X'D9g' 5250 class structured field 
4 Type X'5F' Remove all GUI constructs structured field type 
Flag Byte 1 Bit 0 A 5494 maps GUI-like characters if set to on 
Bits 1-7 Reserved (must be set to off) 


Flag Byte 2 Bits O—7 Reserved (must be set to off) 


Reserved X'00' Reserved 


The 3486, 3487, and 3488 NWSs support GUI-like characters that can be created 
using the WDSF order or the RESTORE command. If you are creating GUI-like 
characters for a new NWS and the map GuUI-like characters parameter is set to on, 
the 5494 maps the GUl-like characters to their character equivalents. This process 
is similar to the READ SCREEN TO PRINT command. See “READ SCREEN TO 
PRINT Command” on page 15-109. 


DEFINE SELECTION FIELD Structured Field 


A selection field is a list from which users select one or more choices. Figure 15-8 


on page 15-69 shows a display panel with several enhanced selection fields, such 


as: 


e Menu bar 

e Push buttons 7 

e Single choice selection field 

¢ Multiple choice selection list that can be scrolled. 


Figure 15-8 on page 15-69 also describes the 5250 display data stream required | 
to build the example screen. 


For a PWS, a selection field can be a GUI construct. Consider the following 
guidelines when working with GUI constructs and selection fields: 


e A GUI construct overlays screen data. Simply creating a selection field does 
not remove a GUI construct, for example, if you issued an SBA order followed 
by data characters. The CREATE WINDOW structured field creates a GUI 
window which can overlay part or all of the GUI selection field. The following 

- commands remove a GUI selection field: 


— CLEAR UNIT command 

— CLEAR UNIT ALTERNATE command 

— RESTORE command 

— RESTORE PARTIAL SCREEN command 

— REMOVE GUI SELECTION FIELD structured field 
— REMOVE ALL GUI CONSTRUCTS structured field. 


e A GUI construct requires equal or less space on the display screen than the 
character equivalent of the selection field. 


e When the selection cursor is on a selection field choice, the cursor row and 
column values in an inbound data stream must be exactly the same as an 
NWS. 
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¢ A PWS should free memory of a GUI window construct or insensitive GUI 
selection field or scroll bar (after a CLEAR FORMAT command or SOH order) 
when the GUI construct is completely covered by another GUI construct. 


The selection field address is the current display address (set with the SBA order) 
when the 5494 receives the DEFINE SELECTION FIELD (DSF) structured field. 
This address defines the position of the leading attribute for the upper left choice. 
If indicators such as check boxes or push buttons are used, the 5494 creates two 
or three columns of data to the left of the current display address. The current 
display address is not modified as a result of the DEFINE SELECTION FIELD 
structured field. 


The following rules must be followed when defining a selection field, or a negative 
response is returned: 


e All fields including selection fields must be defined in descending left-to-right 
order on the screen. Subsequent entry or selection fields can be defined after 
the DSF structured field is issued. 


e The selection field presentation area must not overlap the presentation area of 
any other selection field or entry field. When placing selection fields or entry 
fields next to another selection field, consider the following: 


— When placing a selection field to the left, the ending attribute of the left field 
must not overlap the first selection field attribute of the selection field to the 
right. 


— When placing a selection field to the right, the leading attribute of the right 
field can be next to either the ending choice text attribute or the ending 
scroll bar attribute but must not overlap either of them. 


¢ You cannot have a selection field and field resequencing on the same display 
screen. See “Resequencing” on page 15-22. 


Major structure byte 8 governs the type of selection fields that are used for 
presentation on a display. Major structure bytes 9 through 11 govern the type of 
workstation for which the selection fields are created and many of the selection field 
characteristics. For the DEFINE SELECTION FIELD structured field, you can use 
the following techniques for defining and presenting selection fields: 


¢« For a PWS, the type of selection field (byte 8) and the GUI device 
characteristics (byte 9) determine how the selection field is presented on the 
display. 


e For 3486, 3487, and 3488 NWSs, the type of selection field and the GUI device 
characteristics (byte 9) determine how the selection field is presented on the 
display. 


e For 3477 NWSs that have the capability to create mnemonic underscoring, the 
type of selection field and mnemonic underscore characteristics (byte 10) 
determine how the selection field is presented on the display. 


¢ For all models prior to the 3477 NWSs that do not have the capability to create 
mnemonic underscoring, the type of selection field byte 11 determines how the 
selection field is presented on the display. 


Note: If you want a consistent cursor position in the inbound data, there is an 
advantage to keeping the screen layout the same for the different types of 
workstations, for example, by the consistent use of selection indicators. 
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DEFINE SELECTION FIELD Major Structure: This major structure is used to 
define the entire selection field. A set of minor structures define individual choices 
and other information. At least one Choice Text minor structure must be included. 
The DSF structured field must follow a WDSF order. 


Table 15-18 describes the format for the define selection field major structure. 


Table 15-18 (Page 1 of 5). Format for Define Selection Field Major Structure 


Byte Name Value 
1-2 Major Length 


3 | Class X'D9' 
Type X'50' 


5 Flag Byte 1 Bits — 
0-1 


iN 


Bits 
2-3 


Bits 
4-5 


Bit 6 

| Bit 7 
6 Flag Byte 2 Bit O 
Bit 1 

Bit 2 

Bit 3 


Bit 4 


Bit 5 


Description 


Length of structured field in bytes (including length bytes). It 
must include a major structure and at least one choice text 
minor structure. 


Class of structured field 

Type of structured field 

Mouse characteristics: 

B'00' Use this selection field in all cases. 


B'01' Use this selection field only if the display does not 
have a mouse. 


B'10' Use this selection field only if the display has a mouse. 
B'11' Reserved. 


Reserved (must be set off) 


Auto-enter: 
B'00' Selection field is not auto-enter 


B'01' Selection field is auto-enter on selection except if 
double-digit numeric selection is used. 


B'10' Selection field is auto-enter on selection or deselection 
except if double-digit numeric selection is used. 


B'11' Selection field is auto-enter on selection except if 
single-digit or double-digit numeric selection is used. 


Auto-select if set to on 
Field MDT 


If set to on, a scroll bar should is created beside the selection 
field choices, and TotalRows and SliderPos that can be 
scrolled are included in the major structure. 


If set to on, one blank is added after the numeric separator 
character. 


If set to on, an asterisk (*) replaces the first character of an 
unavailable choice on a monochrome display. 


If set to on, cursor is limited to input-capable positions only. 


If set to on, the Field Advance/Field Backspace function is like 
the Character Advance/Character Backspace keys within this 
selection field. 


If set to on, the cursor movement keys are not allowed to exit 
this selection field. 





Bits 
6-7 
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Reserved (must be set to off) 
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Byte 
7 


Name Value 

Flag Byte 3 Bit O 
Bits 
1-7 


Type of Selection Field 


GUI Device Characteristics: Bits 
This byte is used if the 0-3 
target device is a GUI PWS 

or a GUI-like NWS. If 

neither of these 

workstations are the 

targets, this byte is ignored. 


Bit 4 


Bits 
5-7 


Description 


If set to on, any selected choices are changed to available 
whenever the keyboard is unlocked. 


Reserved (must be set to off) 


Defines the type of selection field: 
X'01' Menu bar 


X'11' — Single choice selection field 

X'12! Multiple choice selection field 

X'21' Single choice selection list 

X'22' Multiple choice selection list 

X'31' Single choice selection field and a pull-down list 


X'32' Multiple choice selection field and a pull-down list 
X'41!' Push buttons 
X'51' Push buttons in a pull-down menu 

Other Values Reserved. 


Indicators: 


B'0000' An indicator to the left of each choice (check box or 
radio button) is created. 1 


B'0010' A push button box is created around choice text and 
the choice text is padded with a blank on both 
sides. 2 


B'0011' A push button indicator specifies each choice 
instead of a push button box on a GUl-like NWS. 
(A GUI PWS treats this setting like B'0010'.) 2 


B'0100' A push button box is created around choice text and 
choice text is padded with a blank on both sides, 
and a leading choice text attribute is written on top 
of the previous choice text ending attribute. 2 


B'0101' A push button indicator specifies each choice 
instead of a push button box on a GUI-like NWS, - 
and a leading choice text attribute is specified on 
top of the previous ending choice text attribute. (A 
GUI PWS treats this setting like B'0100'.) 2 


B'0110' A push button box is created around choice text 
(with no padding). 2 


B'1111' There are no indicators for this value. It is valid for 
all types of selection fields. 


Other Values Reserved. 
Reserved 
Selection techniques: 


B'001' Defines a mnemonic (or numeric) selection for some 
or all of the choices. The mnemonic is 
underscored. 


B'010' Defines a mnemonic (or numeric) selection for some 
or all of the choices. The mnemonic is not 
underscored. 


B'111' No mnemonic (or numeric) selection is specified. 


Other Values Reserved. 
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Table 15-18 (Page 3 of 5). Format for Define Selection Field Major Structure 


Byte _ Name | Value 
10 NWS with Mnemonic Bits 
Underscore Characteristics: 0-3 


This byte is used if the 
target device is a non-GUI 
NWS or a non-GUI PWS, 
both of which are capable 
of underscoring mnemonics. 
This byte is ignored if these 
are not the target devices. 


Bit 4 


Bits 
5—7 
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Description 


Indicators: 


B'0000' An indicator to the left of each choice (for example, 


a slash (/)) is created. ! 


B'0011' A push button indicator specifies each choice. 2 


B'0101' A push button indicator specifies each choice, and a 


leading choice text attribute is specified on top of a 
previous ending choice text attribute. 2 


B'1000' A numeric field to the left of the first choice is 


created. (Single- or double-digit numeric fields are 


determined by bits 5-7.) 3 


B'1111' No indicators are specified for this value. This is 


valid for all types of selection fields. 


Other Values Reserved. 


Reserved 


Selection techniques: 


B'001' 


B'010' 


B'100' 


B'101' 


B'111' 


Defines a mnemonic (or numeric) selection for some 
or all of the choices. The mnemonic is 
underscored. A negative response is sent if bits 0 
through 3 specifies a numeric field to the left of a 
choice. 


Defines a mnemonic (or numeric) selection for some 
or all of the choices. The mnemonic is not 
underscored. A negative response is sent if bits 0 
through 3 specifies a numeric field to the left of a 
choice. 


Defines a single-digit numeric selection. A negative 
response is sent if bits O through 3 did not specify a 
numeric field to the left of a choice. 


Defines a double-digit numeric selection. A 
negative response is sent if bits 0 through 3 did not 
specify a numeric field to the left of a choice. 


No mnemonic or numeric selection is defined. 


Other Values Reserved. 
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Byte 
11 


12 
13 
14 
15 
16 


17 


18 


19 


20 


Name Value 
NWS without Mnemonic Bits 
Underscore Characteristics: 0-3 


This byte is used if the 
target device is a non-GUI 
NWS, which is not capable 
of underscoring mnemonics. 
This byte is ignored if this is 
not the target device. 


Bit 4 

Bits 

5-7 
Reserved X'00' 
Reserved X'00' 
TextSize 1—nn 
Rows ~ d=nn 
Columns or Menu Bar 1—nn 
Choices 
Padding Between Choices 0—nn 


Numeric Separator 
Character - 


Country Specific Selection 
Character 


Mouse Pull-Down Cancel 
AID 


Description 
Indicators: 


B'0000' An indicator to the left of each choice (for example, 
a slash (/)) is created. 1 


B'0011' A push button indicator specifies each choice. 2 


B'0101' A push button indicator specifies each choice, anda 
leading choice text attribute is specified on top of a 
previous ending choice text attribute. 2 


B'1000' A numeric field to the left of the first choice is 
created. (Single- or double-digit numeric fields are 
determined by bits 5-7.) 3 


B'1111' No indicators are specified for this value. This is 
valid for all types of selection fields. 


Other Values Reserved. 
Reserved 
Selection techniques: 


B'010' Defines a mnemonic (or numeric) selection for some 
or all of the choices. The mnemonic is not 
underscored. A negative response is sent if bits 0 
through 3 specifies a numeric field to the left of a 
choice. 


B'100' Defines a single-digit numeric selection. A negative 
response is sent if bits O through 3 did not specify a 
numeric field to the left of a choice. 


B'101' Defines a double-digit numeric selection. A 
negative response is sent if bits 0 through 3 did not 
specify a numeric field to the left of a choice. 


B'111' No mnemonic or numeric selection is defined. 
Other Values Reserved. 

Reserved (must be zero) 

Reserved (must be zero) 

Size of selection field choice text. 

Number of rows of choices to be displayed. 


Number of columns of choices to be displayed or the 
maximum number of menu bar choices. 


Number of columns of nulls to place between choices. 


If a NWS uses numeric selection, the numeric separator 
character is defined here. If zero is specified, the default 
numeric separator character, period (.), is used. 


Country specific selection character to be used along with the 
character slash (/). 


If you are using a pull-down selection field, you can specify an 
AID to be sent to the user if a selection is made outside of the 
pull-down selection field. 
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Byte Name Value Description 
21-24 TotalRows or Minor >2 Only include this parameter if you want to create a scroll bar 
or 21-n Structures that can be beside a selection field. The value specified here is the total 
Scrolled number of rows in a selection field available to an AS/400 
user. 
25-28 - SliderPos that can be Only include this parameter if you want to create a scroll bar 
Scrolled beside a selection field. The value specified here is the total 
number of rows that can be scrolled in a selection field above 
the first row defined to the 5494. 
21—n or Minor Structures Selection field minor structures. See “Define Selection Field 
29—n Minor Structure” on page 15-56. 
Notes: 


1 A negative response is sent if one of the following types of selection fields are specified: Menu bar, push buttons, 
or push buttons in a pull-down menu. 


20 A negative response is sent if the selection field type is not a push button or push button in a pull-down menu. 


3 A negative response is sent if one of the following types of selection fields are specified: Menu bar, push buttons, 
push buttons in a pull-down menu, multiple choice field, or multiple choice list. 


DEFINE SELECTION FIELD Major Structure Flags: The DSF major structure flags 
are defined as follows: 


Mouse: This parameter enables you to send two DEFINE SELECTION FIELD 
commands in a single display data stream. One of the commands is processed 
(based on the existence of a mouse), and the other command is ignored. 


Auto-Enter: \t is recommended that you define menu bars and pushbuttons as 
auto-enter. In an auto-enter selection field, the user can return field data to the 
AS/400 application when a select (or deselect) is made in the field. If auto-enter is 
not defined, the user must press a key that creates an AID. If a double-digit 
numeric selection field is being used, auto-enter is not allowed (auto-enter is 
ignored). If this parameter is B'00', auto-enter is not defined for the field. If the 
parameter is B'10', auto-enter is defined also for deselect. If the parameter is 
B'11', auto-enter is not allowed for single or double-digit numeric selection fields. 


Auto-Select: When you use this parameter for a selection field (and the cursor is 
in the selection field), pressing the Enter key causes the choice to be selected 
before the inbound data is sent as a result of pressing the Enter key. 


Note: This parameter is considered set to on for a.single- or double-digit numeric 
selection field. 


Field MDT: The modified data tag (MDT) is similar to entry fields in that it can be 
activated by an AS/400 application. The 5494 activates this parameter whenever a 
user selects a field choice. This parameter can be reset by any one of the 
following commands or functions: 


e CLEAR UNIT command 

CLEAR UNIT ALTERNATE command 
CLEAR FORMAT TABLE command 
Start of header order 

Write to display control characters. 
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Write Scroll Bar: When this parameter is used, a scroll bar is created to the right 
of a specified selection field. Also, the TotalRows and SliderPos parameters are 
included in the major structure. 


Note: Do not use this parameter if you want the user to scroll a selection field 
without a scroll bar. 


Pad After Numeric Separator: This parameter can be set to on if a single- or 
double-digit numeric selection is used for a non-GUI NWS. 


When this parameter is set to on, the 5494 will add one blank between the numeric 
separator character and the first choice text character. 


Replace Character on Unavailable Choice: This parameter is used when you are 
working with a device that is not capable of indicating to the user that a choice is 
unavailable. A monochrome NWS is an example of such a device. This parameter 
causes the first choice text character to be replaced with an asterisk (*) for any 
unavailable choices. You can customize the asterisk (*) character by using the 
choice indicator minor structure. 


Note: For color displays, there are three color attribute values for the three 
different choice states on a selection field: 


e A color indicating that the choice is available 
e Acolor indicating that the choice has been selected 
e Acolor indicating that the choice is unavailable. 


For monochrome displays, there are two attribute values: 


¢ Normal color indicating that the choice is available or unavailable 
e The intensity attribute indicates that the choice is selected. 


Cursor Movement to Input-Capable Positions Only: \f this flag is set to on, the four 
cursor movement keys are allowed to move only to input-capable positions on the 
display screen. This cursor movement mode applies to the entire display screen. 


Field Advance and Field Backspace Keys Function Like Character Advance and 
Character Backspace Keys: lf set to on, the Field Advance key functions like the 
Character Advance key within this selection field, and the Field Backspace key 
functions like the Character Backspace key within this selection field. If the cursor 
enters a selection field with this parameter set on using the Field Backspace key, 
the selection cursor is positioned on the last choice that can accept the cursor 
within the selection field. 


Cursor Movement Keys are not Allowed to Exit this Selection Field: \f set to on, 
the four cursor movement keys are not allowed to exit this selection field. 


Change Selected Choices to Available Choices on Unlock: \f set to on, any 
selected (default) choices are changed to available (not a default choice) whenever 
the keyboard is unlocked as a result of a WRITE TO DISPLAY command. This 
function precludes having default selections. 


Types of Selection Fields: Selection fields that are single choice allow the user to 


select one choice. Selection fields that are multiple choice allow the user to select 
any number of choices. The following types of selection fields are defined: 
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Menu Bar: This single-choice selection field creates either a single row choice or 
multiple rows of choices that do not have selection indicators. Mnemonic selection 
is allowed. Menu bars are normally specified with the auto-enter and auto-select 
parameters. A menu bar typically extends across the entire row of the display 
screen or the window; no data should be written beside a menu bar (on the same 
row). A menu bar will typically have a separator line below the menu bar. 
However, if no separator line is desired (to save one row on the display screen), 
see the Draw Menu Bar Separator Minor structure. For more information on NWS 
Menu Bar Presentation see page 15-71. 


Single Choice Selection Field: The AS/400 application user determines whether or 
not to create indicators. The indicators are radio buttons to the left of each choice 
on a GUI PWS and GUI-like NWS. For a non-GUl-like NWS, there are two types 
of indicators. The indicators are either character indicators to the left of each 
choice or a single- or double-digit numeric selection indicator to the left of the first 
choice. Mnemonic selection is allowed. For more information, see “NWS Single 
Choice Selection Field Presentation” on page 15-72. 


Multiple Choice Selection Field: The AS/400 application user determines whether 
or not to create indicators. The indicators are check boxes to the left of each 
choice on a GUI PWS and GUI-like NWS. Mnemonic selection is allowed. Fora 
non-GUI-like NWS, the indicators are character indicators to the left of each choice. 
For more information, see “NWS Multiple Choice Selection Field Presentation” on 
page 15-75. 


Single Choice Selection List: The AS/400 application user determines whether or 
not to create indicators. Unlike the Single Choice Selection Field, you can define a 
vertical scroll bar in the selection list. The indicators are radio buttons to the left of 
each choice on a GUI PWS and GuUI-like NWS. Mnemonic selection is allowed. 
For a non-GUI-like NWS, there are two types of indicators. The indicators are 
either character indicators to the left of each choice or a single- or double-digit 
numeric selection indicator to the left of the first choice. For more information, see 
“NWS Single Choice Selection List Presentation” on page 15-76. 


Multiple Choice Selection List: Tne AS/400 application user determines whether or 
not to create indicators. Unlike the Multiple Choice Selection Field, you can define 
a vertical scroll bar in a selection list. The indicators are check boxes to the left of 
each choice on a GUI PWS and GUI-like NWS. For a non-GUl-like NWS, the 
indicators are character indicators to the left of each choice. Mnemonic selection is 
allowed. For more information, see “NWS Multiple Choice Selection List 
Presentation” on page 15-77. 3 


Single Choice Selection Field (List) in a Pull-Down Menu: The AS/400 application 
user determines whether or not to create a single choice pull-down menu using a 
selection field or selection list. A GUI PWS uses a different highlighting style for 
specifying a menu bar or a pull-down menu. Mnemonic selection and single- and 
double-digit numeric selection are allowed. For more information, see “NWS 
Selection Field (List) in a Pull-Down Menu Presentation” on page 15-77. 


Multiple Choice Selection Field (List) in a Pull-Down Menu: The AS/400 application 


_ user determines whether or not to create a multiple choice pull-down menu in a 


selection field or selection list. A GUI PWS uses a different highlighting style for 
specifying a menu bar or a pull-down menu. Mnemonic selection is allowed. For 
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more information, see “NWS Selection Field (List) in a Pull-Down Menu 
Presentation” on page 15-77. 


Push Buttons: This field is a single choice selection field. GUI PWSs and NWSs 
can create push buttons. Some NWSs create a box around each choice. Others 
create push button-like characters around each choice. When using the push 
button field, the auto-enter and auto-select parameters are normally specified. 
Different choices can be presented depending on the existence of a pointing 
device. Mnemonic selection is allowed. For more information, see “NWS Push 
Button Presentation” on page 15-78. 


Push Buttons in a Pull-Down Menu: You can use this field just like the push button 
field. A GUI PWS uses a different highlighting style from an NWS display for 
specifying a menu bar or a pull-down menu. | 


GUI Device Characteristics: \|f you are using a GUI PWS or a GUI-like NWS, the 
GUI device characteristics define the indicators and selection techniques used for 
creating windows. 


Indicators: Use this selection to specify the type of indicators that you want to use. 


Note: You can cause some performance degradation by creating push button 
boxes around push button text when the WRITE TO DISPLAY command is 
processing. This is also true if you issue either the SAVE or RESTORE command. 


Selection Techniques: Use this selection to specify the type of selection field that 
you want to use. Mnemonic selection is allowed. Numeric characters are valid 
mnemonics. (The AS/400 application places numeric characters in the choice text.) 


Note: You can cause some performance degradation by creating underscores for 
mnemonic characters when the WRITE TO DISPLAY command is processing. This 
is also true if you issue either the SAVE or RESTORE command. 


Underscoring Mnemonics with a NWS: lf you are using an NWS that is not 
capable of creating GUI characters (but is capable of underscoring mnemonics), 
this selection enables you to define indicators and selection techniques. 


Indicators: Use this selection to specify the type of indicator that you want. You 
can customize indicator characters by using the choice indicator minor structure. 


~ Selection Techniques: Use this selection to specify the type of selection field that 
you want to use. Mnemonic selection is allowed. Numeric characters are valid 
mnemonics. (The AS/400 application places numeric characters in the choice text.) 


Note: You can cause some performance degradation by creating underscores for 
mnemonic characters when the WRITE TO DISPLAY command is processing. This 
is also true if you issue either a SAVE command or a RESTORE command. 


Inability to Underscore Mnemonics with an NWS: If you are using an NWS that is 
not capable of creating GUI characters (and is also not capable of underscoring 
mnemonics), this selection enables you to define indicators and selection 
techniques. 7 


Indicators: Use this selection to specify the type of indicators that you want to use. 


You can customize indicator characters by using the choice indicator minor 
structure. 
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Selection Techniques: Use this selection to specify the type of selection field that 
you want to use. Mnemonic selection is allowed. Numeric characters are valid 
mnemonics. (The AS/400 application places numeric characters in the choice text.) 


Field Presentation Parameters: The field presentation parameters are defined as 
follows: 


TextSize: The textsize parameter defines the amount of space that you want to 
use for choice text. The space is specified between the leading choice text 
attribute and the ending choice text attribute. The textsize must be equal to or 
greater than the longest choice text phrase in the selection field. If you use single- 
or double-digit numeric selection, push buttons with indicator characters, or blanks 
padding each side, each of these characters is counted as part of the text size in 
the choice text minor structure. The AS/400 application user ensures that the text 
size is at least two or three characters greater than the longest choice text phrase. 
If your choice text ends up being longer than the specified textsize value, the 
choice text is truncated. The 5494 pads the choice text on the right with blanks if 
the choice text is shorter than the specified textsize value. However, the 5494 


_ does not pad the choice text for a menu bar or any type of selection field that has 


only a single row of text. If a selection field or an associated scroll bar extends 
beyond the right edge of the display screen, you will receive a negative response. 


Rows: The rows parameter defines the number of rows that you want displayed 
within a field presentation area. If a value of 1 is specified, the 5494 does not pad 
any choices that are less than the textsize value. (AS/400 application users can 
pad choices with nulls or blanks). If your selection field has an associated scroll 
bar, this value must be greater than 2 or a negative response is returned. If your 
selection field is a menu bar, this parameter is ignored. 


Columns or Menu Bar Choices: For a non-menu bar selection field, this parameter 
defines the number of columns of choices to be displayed within the field 
presentation area. The 5494 specifies the required space in the field format table 
(FFT). This enables you to go back to the FFT and redefine the values if you want 
to change them later. 


For a menu bar selection field, this parameter defines the maximum number of 
choices available to the AS/400 application user. The 5494 specifies the required 
space and the required number of choices in the FFT. When specifying a menu 
bar, the parameter that specifies when a new row is started must be specified in 
the choice text minor structure. 


Padding Between Choices: This parameter specifies whether nulls are to be 
placed between selection field choices. If 0 is specified, no nulls are added. If the 
column or menu bar choices parameter value is 1, this parameter is ignored. Also, 
if push button leading choice text attributes are to overwrite previous ending choice 
text attributes, this parameter is ignored. 


Note: When the user moves the cursor to the left or right within a selection field, 
the cursor skips over padded nulls. 


Numeric Separator: The numeric separator character is used if single- or 
double-digit numeric selections are used for an NWS. The separator character is 
placed to the right of the single- or double-digit numeric character. If 0 is specified, 
the default numeric separator character, period (.), is used. 
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Country Selection: This parameter defines a selection character that can be used 
to select choices. A country specific character is used in addition to the slash (/) 
character. A value of X'00' indicates no country specific selection character. The 
last specified define selection field major structure determines the country specific 
selection character. 


Pull-Down Menu Cancel AID: Specify an AID in this parameter if a selection field 
is inside of a pull-down menu. This enables the user to cancel the pull-down menu 
while using a pointer device (instead of the user having to use the keyboard to 
cancel the pull-down menu). You can use the same AID that is used when a user 
cancels a pull-down menu from the keyboard. If the user of the display is using a 
pointer device and an AID is specified, a special mode is set when the user selects 
something on the screen that has no specific meaning. The text cursor is moved to 
the location of the pointer device cursor, the keyboard is locked, and the specified 
AID is returned to the AS/400 system. Depending on the specified AID, inbound 
data can be included. The special mode is reset when any of the following 
commands or functions are received by the NWS: 


e CLEAR UNIT command 

e CLEAR UNIT ALTERNATE command 

e CLEAR FORMAT TABLE command 

e RESTORE command 

e RESTORE PARTIAL SCREEN command 
e SOH order. 


Specify X'00' for this parameter if you do not want to send a pull-down menu 
cancel AID to the user. If a selection field is not defined as a selection field in a 
pull-down menu, this parameter is ignored. 


TotalRows: Use this parameter if you want to create a scroll bar beside a selection 
field. This parameter defines the total number of rows in a selection field and is 
used to determine the slider size of the scroll bar. If you use this parameter, you 
must specify single choice selection list or multiple choice selection list for the type 
of selection field, otherwise a negative response is returned. 


SliderPos: Use this parameter if you want to create a scroll bar beside a selection 
field. This parameter determines the position of the top of the slider in the scroll 
bar. This parameter defines the total number of rows in the selection field above 
what is defined to the 5494. This parameter and the totalrows parameter enables 
the 5494 to determine: 


e The size of the slider 
e The size of the space above the slider in the scroll bar 
e The size of the space below the slider in the scroll bar. 


If the sliderpos parameter value and the rows parameter value is greater than the 
totalrows parameter value, a negative response is returned. 
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Selection Field Presentation Area: For all selection field types (except a menu 
bar), the selection field presentation area is a rectangular area on the display 
screen. The size and layout of the selection field presentation area is determined 
by the following parameters and characteristics: 


e¢ For a menu bar or any single row selection field, choice text is not padded up 
to the textsize value. Note that each choice text is bound by a leading and 
ending choice text attribute that uses one column on the display screen. 


e The columns parameter is not valid for menu bars. 
e The rows parameter is not valid for menu bars. 


e If indicators are placed to the left of each choice, this adds two columns to 
each choice. 


e If single-digit numeric selection is used, this adds two columns to each choice. 


e If double-digit numeric selection is used, this adds three columns to the first 
column of choices and two columns for subsequent columns of choices. 


e Padding between choices adds columns between each column of choices. 


e If ascroll bar is created, add two columns to each row. 


The 5494 sends a negative response if: 


e The selection field extends beyond the last column of the display screen 
e The selection field extends beyond the last row of the display screen 
e The selection field indicators are created before the first column. 


The 5494 truncates the choice text specified by the AS/400 system if the choice 
text (between the leading and ending choice text attributes) is greater than the 
textsize value. The following specified values determine the choice text layout: 


-¢ For a single-digit numeric selection, the specified single-digit number, the 
numeric separator character, and an optional blank are added in front of the 
choice text specified by the AS/400 application user. 


¢ For a double-digit numeric selection, the specified two-digit number, the 
numeric separator character, and an optional blank are added in front of the 
choice text specified by the AS/400 application user. 


e For push buttons, an indicator character or optional blank is added in front of 
and after the choice text specified by the AS/400 application user. 


See “Presenting Selection Field Choices” on page 15-68 for some examples of 
selection field layouts. 


Choice Text Minor Structure: When defining a selection field, you must use a 
choice text minor structure to define each selection field choice. 


At least one choice that can be selected with a cursor must be defined. The total 
number of choices defined must be equal to or less than the product of the total 
number of the rows and columns parameter values (or menu bar choices for a 
menu bar). 


Functions Reference 


If the total number of choices is less than the product of the total number of rows 
and columns (or menu choices), and the selection field is redefined, the 5494 
deletes the remaining choices. 


Table 15-19 (Page 1 of 2). Format for Choice Text Minor Structure 


Byte 
1 
2 
3 


Name 

Minor length 
Type 

Flag Byte 1 


Flag Byte 2 


Value 
>4 
X'10' 


Bits 
0-1 


Bit 2 


Bit 3 
Bit 4 


Bit 5 


Bits 
6-7 


Bit 0 
Bit 1 


Bit 2 


Bit 3 


Bit 4 


Bit 5 
Bit 6 
Bit 7 


Description 

Length of minor structure in bytes (including length byte). 
Choice text minor structure type. 

Choice state: 


B'00' Available and not a default selection 

B'01' Available and is a default selection (selected 
state) 

B'10' Not available 

B'11' Reserved. 


If set to on, specifies a menu bar choice that starts a new 
row. 


Reserved (set to zero). 


If set to on, specifies that a mnemonic offset is included in the 
minor structure. 


If set to on, specifies an AID if selected is included in this 
minor structure. 


Numeric selection characters: 


B'00' Numeric selection characters are not included in this 
minor structure. 


B'01' A single-digit numeric selection character is included 
in this minor structure. 


B'10' Double-digit numeric selection characters are 
included in this minor structure. 


B'11' Reserved. 
If set to on, the choice cannot accept a cursor. 


If set to on, the application user desires a roll-down AID if the 
Cursor Up key is pressed on this choice. 


If set to on, the application user desires a roll-up AID if the 
Cursor Down key is pressed on this choice. 


If set to on, the application user desires a roll-left AID if the 
Cursor Left key is pressed on this choice. 


If set to on, the application user desires a roll-right AID if the 
Cursor Right key is pressed on this choice. 


If set to on, no push-button box is written for this choice. 
Reserved (set to zero) 


If set to on, cursor direction is right to left. 
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Byte 
5 


6 or 7 


15-58 


Name 
Flag Byte 3 


Value Description 


At least one of the following three flags must be set to on, 
otherwise the choice text minor structure is ignored. 


Bit O If set to on, use this minor structure for GUI devices (including 
GUI-like NWSs). 


Bit 1 If set to on, use this minor structure for non-GUI NWSs that _ 
are capable of creating mnemonic underscores. 


Bit 2 If set to on, use this minor structure for NWS display devices 
that are not capable of creating underscores. 


Bits Reserved (must be set to off). 
3-7 


Mnemonic Offset (if Offsets mnemonic within choice text. This parameter is 


included) 


included in the choice text minor structure only when the 
mnemonic offset (flag byte, bit 4) is set to on. 


AID (if included) | The AID to be used if the choice is selected. This parameter 


is only included in the choice text minor structure if the AID if 
selected (flag byte, bit 5) is set to on. 


Numeric Characters (if If single-digit numeric selection is defined, one numeric 


included) 


Choice Text 


character is included. If double-digit numeric selection is 
defined, two characters are included. This parameter is only 
included in the choice text minor structure if the numeric 
selection characters two-bit field (flag byte 1, bit 6-7) is 
non-zero. 


Selection field choice text. 


Choice Text Minor Structure Flags: The choice text minor structure parameters are 
described as follows: 


Choice State: \|f this parameter is set to B'00', the choice is available and is not a 
default selection. If this parameter is set to B'01', the choice is available and the 
choice is selected (default selection). If this parameter is set to B'10', the choice 
is unavailable. 


For the default selection, the 5494 indicates to the user that this choice is selected 
by providing a specific highlighted feature. The definition of the default selection 
does not affect the field MDT. See “Presenting Selection Field Choices” on page 
15-68 for more information on how choice availability affects selection. 


Menu Bar Starting a New Row: The menu bar choice that starts a new row flag 
(when set to on) indicates to the 5494 that the choice should be placed on the next 
row. The column numbers of the leading choice text attributes of the specified 
choice and the first choice are equal. If you are specifying a single row choice in a 
menu bar, do not set this parameter to on. 


Mnemonic Offset: lf set to on, this parameter notifies the 5494 that a mnemonic 
offset parameter is included in the data stream (in byte 6) for the specified choice. 


Functions Reference 


AID If Selected: \f set to on, this parameter notifies the 5494 that an AID is 
included in the data stream (in byte 6 or 7, depending on whether a mnemonic 
offset is specified) for the specified choice. | 


Numeric Selection Characters: lf set to on, this parameter notifies the 5494 that 
either single- or double-digit selection characters are included in the data stream (in 
bytes 6, 7, or 8, depending on whether a mnemonic offset and an AID instruction 
are specified) for the specified choice. If this parameter is set to B'01', a 
single-digit numeric character is included. If this parameter is set to B'10', two 
double-digit numeric characters are included. If single- or double-digit selection is 
used, and the choice accepts a cursor, this parameter must be non-zero. 


Instruction for Cursor to Skip Choice: lf set to on, this parameter prevents the user 
from selecting the specified choice with the cursor. 


Top Choice: \f set to on, this parameter notifies the 5494 that the AS/400 
application user must receive a roll-down AID when the Cursor Up key is pressed 
on the specified choice. This parameter can be used for any choice. Generally, 
the specified choice is the first choice available to the 5494 within the selection 
field, and additional choices are available above this choice. The selection field is 
not required to have a scroll bar. The 5494 uses this information to support 
cursor-sensitive scrolling. For more information, see “Scrolling the Choice List” on 
page 15-86. 


Note: Numeric and mnemonic selection selects only choices that are currently 
defined to the 5494. This is also true of the deselect function associated with the 
display user selecting a choice in a single choice selection list. 


Last Choice: \f set to on, this parameter notifies the 5494 that the AS/400 
application user must receive a roll-up AID when the Cursor Down key is pressed 
on the specified choice. You can use this parameter for any choice. The 5494 
uses this information to support cursor-sensitive scrolling. For more information, 
see “Scrolling the Choice List” on page 15-86. 


Left Choice: \|f set to on, this parameter notifies the 5494 that the AS/400 
application user must receive a roll-left AID when the Cursor Left key is pressed on 
the specified choice. This parameter can be used to support pull-down menu 
browse. Generally, the specified choice is the first choice available to the 5494 
within the selection field, and additional choices are available to the left of the 
specified choice. The 5494 uses this information to support cursor-sensitive 
scrolling. For more information, see “Scrolling the Choice List” on page 15-86. 


Right Choice: \f set to on, this parameter notifies the 5494 that the AS/400 
application user must receive a roll-right AID when the Cursor Right key is pressed 
on the specified choice. This parameter can be used to support pull-down menu 
browse. Generally, the specified choice is the last choice available within the 
selection field, and additional choices are available to the right of the specified 
choice. The 5494 uses this information to support cursor-sensitive scrolling. For 
more information, see “Scrolling the Choice List” on page 15-86. 


No Push-Button Box: lf set to on, the 5494 does the following: 


e If the display is capable of drawing push-button boxes, and push-button boxes 
are specified in the major structure, then no push-button box is drawn for this 
choice. 
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e If the display is not capable of drawing push-button boxes, and left and right 
push-button characters are specified in the major structure, then a blank is 
used instead of the left and right push-button characters for this choice. 


e If this selection field is not a push-button selection field, this flag is ignored. 


Cursor Direction: \f set to on, the cursor direction for this choice is right to left. 
This flag has no effect on the presentation of the choice. 


Use Minor Structure Flags: Three parameter flags are available. These 
parameters are used to direct a Choice Text minor structure to one or more types 
of workstations. If no flags are set to on, the Choice Text minor structure is 
ignored. The parameter selection allows different characteristics or text for different 
workstation types. For example, if mnemonic underscoring is available, the choice 
text can be presented as Exit. However, not all NWSs can underscore mnemonics. 
A different choice text minor structure for NWSs that cannot underscore mnemonics 
may be specified as: 


e 5. Exit 
¢ exit 
e Exit(x). 


You must set all three parameter flags to on if the choice text minor structure - 
applies to all workstation types. 


Choice Text Minor Structure Optional Parameters: The following are descriptions 
of the choice text minor structure optional parameters: 


Mnemonic Offset: \f set to on, this optional parameter defines the position of a 
mnemonic or numeric character within the choice text. The mnemonic offset 
parameter contains the offset within the choice text (starting with 0 for first 
character) of the mnemonic or numeric character associated with the specified 
choice. The major structure defines whether the numeric or mnemonic character is 
underscored (NWS 3477, 3486, and 3487 are capable of creating mnemonic 
underscoring). The mnemonic or numeric character does not need to be 
underscored to be recognized by the keyboard. If the major structure defines a 
selection field as having mnemonic selection, not all choices need to have a 
numeric or mnemonic character (set the mnemonic offset parameter to off). This 
parameter is ignored if a major structure defines a selection field as not having 
mnemonic selection. 


AID If Selected: \f set to on, this optional parameter defines an AID to be returned 
in the inbound data stream instead of the enter AID (which is used for auto-enter) 
when the specified choice is selected. This parameter is ignored if any of the 
following are true: 


e The specified AID is not a currently defined AID (See Table 16-1 on 
page 16-5). 


e The selection field is defined as auto-enter. 
e The selection field is not defined as auto-select. 


e The choice is unavailable for selection. 


Depending on the specified AID, inbound data can be included. 


Functions Reference 


Numeric Characters: \f set to on, this optional 1- or 2-character parameter contains 
1- or 2-numeric digits to be used in a single- or double-digit numeric selection field. 
This parameter is ignored if the major structure does not define this selection as 
single- or double-digit. 


The 5494 sends a negative response if the major structure defines a single-digit 
numeric selection field, this choice accepts a cursor, and a single-digit numeric 
character is not included in the data stream. The 5494 sends a negative response 
if a character is not a valid numeric character (X'FO'-X'F9'). 


The 5494 sends a negative response if the major structure defines a double-digit 
numeric selection field, this choice accepts a cursor, and a double-digit numeric 
character is not included in the data stream. The 5494 sends a negative response 
if the first character is not a blank or a valid numeric character, or the second 
character is not a valid numeric character. 


Choice Text: This optional parameter includes a string of character data that 
describes the field choice. Text data must not include display attributes. If you are 
using mnemonic selection, the mnemonic is contained within the choice text where 
an offset is specified. Choice text can contain spaces and nulls, which are used 
without alteration by the 5494. 


You can specify an empty choice (where no choice text is included). This causes 
the 5494 to create a null choice in the next choice position (except for a menu bar 
or any selection field with a single row). In the case of menu bars or single row 
selection fields, an empty choice is ignored. Empty choices can be used to 
separate related groups of choices. The user is not able to position the selection 
cursor on an empty choice. If an empty choice selection field has indicators 
specified to the left of the choice text, the null indicator is used. 


If the length of the choice text exceeds the textsize value, the choice text is 
truncated. 


Draw Menu Bar Separator Minor Structure: The optional draw menu bar 
separator minor structure causes a separator line to be drawn on the row after the 
last choice in the selection field. It is recommended that you use this minor 
structure to create the separator line instead of using a different data stream 
method (for example, SBA followed by the separator characters). 


Note: If no separator line is desired and you want to save a screen row, do the 
following steps when presenting a pull-down window in order to have proper 
presentation on NWS and PWS: 


1. A Save or Save Partial may be done by the application 
2. Then, the data stream that creates the pull-down should include: 


e CLEAR FORMAT command or SOH order 

e CREATE WINDOW structured field for the window (typically to row 1) 

e DEFINE SELECTION FIELD structured field to define the menu bar 

e Define the data inside the pull-down (typically a selection field to row 2) 


The 5494 creates a separator line that consists of the following components: 


e An optional leading attribute (to the start column), which is specified in the 
minor structure. The default leading attribute is normal display (X'20') on 
monochrome displays and blue (X'3A') on color displays. 
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e Either the default separator character (a solid separator line character if 
available), the dash (—), or the character specified in the minor structure. 


e lf a leading attribute was written, a trailing normal display attribute is written to 
the end column of the row by the 5494. 


Depending on the PWS, other methods can be used to separate the menu bar from 
the window (for example, background color). 


lf you are using two or more rows in a menu bar, the minor structure must be sent 
after all choice text minor structures are issued (the separator line is drawn on the 


row after the last choice). 


You can customize both monochrome and color displays using the same minor 
structure; therefore, AS/400 applications do not need to check display types at run 


time. 


If you update a selection field, it is necessary to resend the menu bar separator 
minor structure only if part of the separator had been overwritten (for example, a 
pull-down menu generally overwrites two of the separator characters). 


Table 15-20. Format for Menu Bar Separator Minor Structure 


Byte 
1 


Functions Reference 


Name 


Minor 
Length 


Type 


Flags 


Start 
Column 


End 
Column 


Monochrome 
Separator 
Emphasis 


Color 
Separator 
Emphasis 


Separator 
Character 


Value 
5-8 


X'09' 


Bit O 


Bit 1 


Bits 2-7 
1-131 


2-132 


- X'00' or 


X'20'-X'3F! 


X'00' or 
X'20'-X'3F' 


X'00' or 
X'01'-X'FE! 


Description 


Length of minor structure in bytes (including 
length byte). 


Defines selection field menu bar separator 
minor structure type. 


Use specified separator character on GUI-like 
NWSs if set to on. 


Suppress writing of leading and ending 
attributes if set to on. 


Reserved (must be set to off). 


Column to start writing the separator line. The 
leading attribute is written to this column, if 
included. If there is no leading attribute, the 
first separator character is written to this 
column. 


Column to end writing the separator line. The 
ending attribute is written to this column, if 
included. If there is no ending attribute, the last 
separator character is written to this column. 


Value of attribute placed in first position of the 
separator line on a monochrome display. If 
X'00' is specified, the default attribute is used. 


Value of attribute placed in first position of the 
separator line on a color display. If X'0O' is 
specified, the default attribute is used. 


Value of the separator character to be used 
across the entire row. If X'00' is specified, the 
default separator character is used. 


When you set the use specified separator character parameter to on, the specified 
separator character is used for GUI-like NWSs. This parameter is ignored if sent to 
a PWS that has GUI capabilities. 


Choice Presentation Display Attributes Minor Structure: This optional minor 
structure enables an AS/400 application to specify the display attribute values to be 
used when presenting selection field choices. The minor structure enables 
customization of both monochrome and color displays using the same minor 
structure; therefore, AS/400 applications do not need to check display types at run 


time. 


The 5494 uses the default display attribute settings for all choices in the specified 
selection field if alternative attribute settings are not specified in the minor structure. 
When the minor structure is issued, it must come before the choice text minor 
structures. If you update a choice (for example, rewriting a list that is scrolled) you 
must resend the choice presentation display attributes minor structure. 


Table 15-21 describes the format for the menu bar separator minor structure. 


Table 15-21 (Page 1 of 2). Format for Choice Presentation Display Attributes Minor Structure 


Byte 
1 
2 


10 


Name 
Minor Length 
Type 


Flags 


Monochrome Selection 
Cursor Available 
Emphasis 


Color Selection Cursor 
Available Emphasis 


Monochrome Selection 
Cursor Selected 
Emphasis 


Color Selection Cursor 
Selected Emphasis 


Monochrome Selection 
Cursor Unavailable 
Emphasis 


Color Selection Cursor 
Unavailable Emphasis 


Monochrome Available 
Emphasis 


Value 
4—19 
X'01' 


Bit 0 


Bit 1 


Bit 2 


Bits 3-7 


X'00' or 
X'20'—X'S3F' 


X'00' or 
X'20'—X'3F' 
X'00' or 
X'20'—X'3F' 


X'OO' or 
X'20'—-X'3F' 
X'00' or 
X'20'—X'3F' 


X'00' or 
X'20'—-X'3F' 
X'00' or 
X'20'—X'3F' 


Description 
Length of minor structure in bytes (including length byte). 


Define selection field display attributes minor structure 
type. 


At least one of the following three flags must be set to on, 
otherwise this minor structure is ignored. 


Uses the minor structure for GUI devices (including 
GUI-like NWSs) if set to on. 


Uses the minor structure for NWSs that are capable of 
creating underscores if set to on. 


Uses the minor structure for NWSs that are not capable of 
creating mnemonic underscores if set to on. 


Reserved (must be set off). 
Value used for the selection cursor display attribute for an 
available choice on a monochrome display. 


Color version of byte 4. 


Value used for the selection cursor display attribute for a 
selected choice on a monochrome display. 


Color version of byte 6. 


Value used for the selection cursor display attribute for an 
unavailable choice on a monochrome display. 


Color version of byte 8. 


Value used for the leading choice text attribute for an 
available choice on a monochrome display. 
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Table 15-21 (Page 2 of 2). Format for Choice Presentation Display Attributes Minor Structure 


Byte 
11 


12 
13 
14 
15 


16 


17 


18 


19 


15-64 


Name 


Color Available Emphasis 


Monochrome Selected 
Emphasis 


Color Selected Emphasis 


Monochrome Unavailable 
Emphasis 


Color Unavailable 
Emphasis 


Monochrome Indicator 
Emphasis 


Color Indicator Emphasis 


Monochrome Unavailable 
Indicator Emphasis 


Color Unavailable 
Indicator Emphasis 


Value 

X'00' or 
X'20'—X'3F' 
X'00' or 
X'20'-X'3F' 
X'00' or 
X'20'—X'3F' 
X'00' or 
X'20'-X'3F' 
X'00' or 
X'20'-X'3F' 
X'00' or 
X'20'-X'3F' 


X'00' or 
X'20'—-X'3F' 
X'00' or 
X'20'-X'3F' 


X'OO' or 
X'20'—X'3F' 


Description 


Color version of byte 10. 


Value used for the leading choice text attribute for a 
selected choice on a monochrome display. 


Color version of byte 12. 


Value used for the leading choice text attribute for an 
unavailable choice on a monochrome display. 


Color version of byte 14. 


Value used for the indicator display attribute to be used on 
a monochrome display (except for an unavailable choice in 
a selection field with indicators to the left of choice 
text—the value is specified in byte 18). This value is 
ignored if this selection field does not have indicators to 
the left of the choice text or if the selection field is not a 
single- or double-digit numeric selection field. Fora 
single- or double-digit numeric selection field, this attribute 
applies only to the first choice. 


Color version of byte 16. 


Value used for the indicator display attribute for an 
unavailable choice on a monochrome display. This value 
is ignored if the specified selection field does not have 
indicators to the left of the choice text. 


Color version of byte 18. 


The three parameter flags, specified in byte 3 of Table 15-21 on page 15-63, 
determine which type or types of display devices use this minor structure. All three 
_ flags can be set to on to customize all device types. 


Specifying an attribute value of X'00' indicates that the default highlighting value is 
used for the entry. If highlighting values are not a valid display attribute, the value 
is ignored and default highlighting is used. A GUI PWS ignores the values in the 
minor structure and uses its normal highlighting attributes. 


It is recommended that you only use one method to highlight selected choices. 
The 5494 uses one of the following methods for highlighting selected choices: 


e Places a selection indicator to the left of each choice. 


e Uses a single- or double-digit indicator field for single- or double-digit numeric 
selection fields. | 


e Uses the leading choice text attribute, if no indicators are used. 


Choice Indicators Minor Structure: This optional minor structure enables an 
AS/400 application to specify the indicator values to be used for presenting 


selection fields. 


Functions Reference 


The 5494 uses the default indicators for this selection field if alternative indicators 
are not specified in the minor structure. When this minor structure is issued, it 


must come before choice text minor structures. 


lf you update a choice (for 


example, rewriting a list that is scrolled), you must resend the choice indicators 
minor structure. The minor structure is ignored if no indicators are used in the 
selection field. 


Table 15-22 describes the format for the choice indicator minor structure. 


Table 15-22. Format for Choice Indicator Minor Structure 


Byte 
1 


Name 


Minor length 


Type 


Flags 


Empty Indicator 
or Left Push 
Button 


Selected 
Indicator or Right 
Push Button 


Character That 
Replaces the 
First Choice Text 
Character for 
Unavailable 
Choices On a 
Monochrome 
Display 


Value 
4—6 


X'02' 


Bit 0 


Bits 1—7 


X'00' or 
X'01'—X'FE' 


X'00' or 
X'01'—X'FE' 


X'00' or 
X'01'—X'FE' 


Description 


Length of minor structure in bytes 
(including length byte). 


Defines the choice indicators minor 
structure type. 


Use the specified indicators on GUl-like 
NWSs if set to on. 


Reserved (must be set to off). 


Value used for the unselected/available 
indicator character if the specified 
selection field has indicators to the left of 
the choice text or left push button 
character. If no push button indicator is 
desired, a blank (X'40') can be specified. 


Value used for the selected indicator 
character if this selection field has 
indicators to the left of the choice text or 
right push button character. If no push 
button indicator is desired, a blank (X'40') 
can be specified. 


Value used for the character that replaces 
the first choice text character for an 
unavailable choice on a display not 
capable of identifying a choice as 
unavailable (most commonly, a 
monochrome display). If the major 
structure flag indicates that replace is off, 
this value is ignored and no replacing is 
done. 


The specified indicator flag is applicable only for bytes 4 and 5 in Table 15-22. If 
you set the specified indicator flag to on, the specified indicators on GUI-like NWSs 
are capable of creating check boxes, radio buttons, or push BHHOnS: A GUI PWS 
ignores this flag and uses its own selection indicators. 


If you specify an indicator value of X'00', the default indicator is used. The 5494 


does not check any of the specified values. 


Scroll Bar Indicators Minor Structure: 


This optional minor structure enables an 


AS/400 application to specify the character values and highlighting to be used when 
creating a scroll bar for a specified selection field. 
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You can also use the minor structure to customize vertical and horizontal scroll bar 
fields. For more information see “DEFINE SCROLL BAR FIELD Structured Field” 
on page 15-88. 


The 5494 uses the default characters for the scroll bar if no alternative characters 
for the scroll bar are specified in the minor structure. When the minor structure is 
issued, it must come before choice text minor structures. If you update a scroll bar, 
you must resend the scroll bar indicators minor structure. The minor structure is 
ignored if no scroll bar is used for the selection field. 


Table 15-23 describes the format for the scroll bar indicators minor structure. 


Table 15-23. Format for Scroll Bar Indicators Minor Structure 


Byte 
1 


10 


Functions Reference 


Name 


Minor 
Length 


Type 


Flags 


Monochrome 
Top of 

Scroll Bar 
Highlighting 


Color Top 
of Scroll 
Bar 
Highlighting 


Monochrome 
Shaft Scroll 
Bar 
Highlighting 


_ Color Shaft 


Scroll Bar 
Highlighting 


Top Scroll 
Bar 
Character 


Bottom 
Scroll Bar 
Character 


Empty 
Scroll Bar 
Character 


Slider Scroll 
Bar 
Character 


Value 
4—11 


X'03' 


Bit O 


Bits 1-7 


X'00' or 
X'20'-X'3F' 


X'00! or 
X'20'-X'3F' 


X'00' or 
X'20'—X'3F' 


X'00' or 
X'20'-X'3F' 


X'00' or 
X'01'-X'FE! 


X'00' or 
X'01'-X'FE! 


X'00' or 
X'01'~X'FE! 


X'00' or 
X'01'-X'FE! 


Description 


Length of minor structure in bytes (including 
length byte). 


Defines the scroll bar indicators minor structure 
type. 


Use the specified indicators on GUL-like NWSs, 
if set to on. 


Reserved (must be set off). 


Value used for the display attribute to be used 
to highlight the top and bottom characters of 
the scroll bar on a monochrome display. Fora 
horizontal scroll bar field, this attribute is used 
for the entire scroll bar. 


Color version of byte 4. 


Value used for the display attribute to be used 
to highlight the shaft portion of the scroll bar 
(between top and bottom indicators) on a 
monochrome display. This attribute is ignored 
for a horizontal scroll bar field. 


Color version of byte 6. 


Value used for the top of scroll bar indicator (or 
left scroll bar indicator for a horizontal scroll bar 
field). 


Value used for the bottom of scroll bar indicator 
(or right scroll bar indicator for a horizontal 
scroll bar field). 


Value used for the empty scroll bar position 
within the scroll bar shaft. 


Value used for the slider scroll bar position 
within the scroll bar shaft. 


When you set the specified indicator flag to on, the specified indicators and display 
attributes are used on a GUI-like NWS. A GUI PWS ignores this flag and uses its 
own GUI scroll bars. 


If you specify a value of X'00', the default character or highlighting is used. The 
5494 does not check any specified character values. 


How the 5494 Processes the Define Selection Field: The 5494 processes the 
define selection field as follows: 


Outbound Data Stream Processing: As with the SF order, the: 


e Insert mode is reset. 

e Keyboard is locked. 

e Outstanding AID requests are cleared. 

e Master MDT bit is set if the selection field MDT is set to on. 

e Keyboard modes are reset when the define selection field structured field is 
received and processed by the 5494. 


Selection Field Choice Definition Limitations: Selection field data is stored in the 
field format table (FFT) storage area. Enough storage is reserved for the maximum 
number of selection field choices. The maximum number of selection field choices 
is either the product of the rows value and the columns value or the maximum 
number of menu bar choices within a menu bar. Two FFT entries are made for 
each selection field choice. If a selection field has an associated scroll bar, three 
additional FFT entries are required. You can specify a maximum of 256 FFT 
entries. If you attempt to define more than 256 FFT entries, the 5494 sends a 
negative response. 


Selection Field Redefinition: Tne AS/400 application user can redefine a selection 
field by sending another define selection field major structure to the same display 
address that was used when the field was initially defined. You must redefine a 
selection field when one or more choices have changed. If the following values do 
not remain the same, the 5494 may send a negative response. 


e Rows value 

e Columns value 

e Textsize value 

e Type of indicators 

¢ Selection techniques 

e Padding between choices 
e Type of selection field 

e Presence of a scroll bar. 


When you redefine a selection field, you can specify more choices or fewer 
choices. However, the maximum number of choices must remain the same (the 
maximum is equal to the number of rows multiplied by the number of columns, or 
the number of menu bar choices within a menu bar). The 5494 deletes any 
choices remaining from the previous definition by erasing a rectangular area using 
the longest selection field row. 


Inbound Selection Field Data: The inbound data from a selection field is 
determined by the existence of a scroll bar and if the selection field is single choice. 


For any single choice selection field (menu bar, push button, or a single choice 
selection field or list), two bytes are returned, which is the selected choice number. 
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If the selected choice number is X'0000', no choice is selected, otherwise the 
selected choice number is the number of the choice that is selected plus X'1F' 
(where the first choice returns X'0020'). All choices are included for numbering 
purposes, including null choices. The choice number is unrelated to the single- or 
double-digit numbers on the display screen. 


For any type of multiple choice selection field (multiple choice selection field or list), 
each choice returns one byte of the selection field data (the product of rows and 
columns or menu bar choices). This is independent of how many choices are 
actually written to the display screen. The data byte that is returned for each 
choice is X'F1' for a selected choice. The data byte that is returned for each 
choice is X'00' for an unselected choice. The data byte is X'00' for possible 
choices that are not perueny on the display screen. 


The selection field has an associated scroll bar, 4 bytes follow selection field data 
(known as a scroll increment). The 4 bytes will be zero unless the requested key is 
a roll-up or roll-down request and the user has selected the scroll bar with a pointer 
device. The increment is always a positive number. If the increment is one, the 
user is requesting to scroll one row. The increment could be quite large if the user 
drags and drops the scroll bar slider using a pointer device. The increment could 
be larger than the number of rows that the AS/400 application user had specified 
for the (up or down) direction when the selection field was defined. 


If a selection cursor is active when an AID is sent to the AS/400, the cursor column 
in the inbound data is set to the first column of the selection cursor (first position to 
the right of the leading choice text attribute). | 


For READ INPUT FIELDS command processing, all inbound data from selection 
fields is returned as specified in the inbound selection field description. Selection 
and eniry field data is positioned in the inbound data stream, ordered by starting 
field address with no field data delimiters. The AS/400 application determines how 
much field data is returned and parses the data appropriately. 


For READ MODIFIED FIELDS command processing and all READ MODIFIED type 
commands, inbound data processing is the same for the READ INPUT FIELDS 
command except that data is returned only if the selection field MDT is set to on. 
The SBA that is returned before the field data is the selection field address (one 
position past the original address that was used to position the selection field). 


For READ IMMEDIATE command processing, all inbound data that is returned is in 
exactly the same format as for the READ INPUT FIELDS command. 


Presenting Selection Field Choices: The 5494 creates selection choices in the 
order that they are issued, one column at a time, in rows from top to bottom. For 
example, the choices in the multiple choice selection list shown in Figure 15-8 on 
page 15-69 are ordered in the data stream as: 


e Cable TV 
e Groceries 
Car 
House 
Charities 
Insurance 
Clothes 
Interest 
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e Gifts 
e Recreation. 


This is consistent with field ordering for the 5250 data stream. 


The 5494 aligns the choice indicators and text. For an example of a selection field 
presentation, see Figure 15-8. 


Edit Browse Delete Print Exit 


MAIN MENU 


Select printer... . / 1. PRINTERO1 
. 2. PRINTEROQZ 
. 3. PRINTERO3 


Select budget codes. . _ Cable TV / Groceries 
_ Car __House 
/ Charities __ Insurance 
/ Clothes __ Interest 
_ Gifts __Recreation 


<Enter=0K> <F12=Cancel> 





Figure 15-8. Selection Field Presentation 


Consider the following explanations for Figure 15-8: 


e The figure represents a NWS that is capable of mnemonic underscoring, but 
not GUI-like presentation. 


— Some NWSs are not capable of creating mnemonic underscores. 
However, mnemonic selection is still allowed. The AS/400 application is 
responsible for identifying the mnemonic characters. 


_ — NWSs 3486 and 3487 support: 


- GUl-like check boxes, radio buttons, and scroll bars 
- A solid menu bar separator line 
- Push button text with a box around it. 


— A GUI PWS supports the following features: 


- GUI scroll bars 

- GUI push buttons 

GUI empty and checked boxes 

- GUI empty and filled-in radio buttons. 


e The selection cursor (not shown) is active on one of the choices. 


¢ The scroll bar is reverse image. 
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All indicators (indicators are optional) and attributes within selection fields can 
be customized. 


You can create Figure 15-8 on page 15-69 with a 5250 display data stream 
containing the following constructs: 
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Escape, CLEAR UNIT command 


Escape, WRITE TO DISPLAY command, and two control characters (typically 
specify keyboard unlock) 


SBA order for row 1 and column 1 
WDSF order 
Define selection field major structure 
— The major structure defines the selection field type as a menu bar. 


— Five choice text minor structures that specify the five choices and define 
the offset for the mnemonic character. 


— A menu bar separator minor structure that specifies where the menu bar 
separator is drawn below the menu bar. 


SBA order for row 3 and column 26 
Attribute, title text, attribute 

SBA order for row 7 and column 1 
Attribute, select printer text, attribute 
SBA order to row 7 and column 28 
WDSF order 

Define selection field major structure 


— The major structure defines the selection field type as a single choice 
selection field. 


— Three choice text minor structures that specify the three choices (choice 1 
is the default choice) and defines the offset for the mnemonic character (in 
this case, numbers 1 through 3). 


SBA order for row 12 and column 1 
Attribute, select budget codes text, attribute 
SBA order for row 12 and column 28 
WDSF order 

Define selection field major structure 


— The major structure defines the type of selection field as a multiple choice 
selection list with a scroll bar. 


— 14 choice text minor structures that specify the 14 choices (and default 
choices). 


SBA order for row 24 and column 26 
WDSF order 


e Define selection field major structure 


— The major structure defines the selection field type as push buttons (and 
specifies padding between choices). 


— Two choice text minor structures that specify the two choices. 
e Escape, READ MDT FIELDS command, and control characters. 
GUI PWS Selection Field Presentation: A GUI PWS presents selection fields as 


GUI constructs. When a GUI construct is used, it requires space on the display 
screen equal to or less than the character equivalent of the selection field. 


NWS Menu Bar Presentation: Examples of presenting a menu bar are shown in 
Figure 15-9 and Figure 15-10. 


Example 1 


@ Edit@ @Browse@ @Delete@ @Print@ GExit@ @ 
@ Complete@ CHelp@ 


Figure 15-9. Menu Bar with Optional Underscored Mnemonics and Separator Line 


Notes: 
1. The at sign (@) indicates an attribute. 


2. The example is supported on a GUI-like NWS that is capable of underscoring 
mnemonics. 


3. The AS/400 system instructs the 5494 to begin a new row on the choice 
named Complete. 


4. The data stream instructs the 5494 to pad between choices with nulls (one null 
is shown). The Cursor Left and Cursor Right keys move the selection cursor 
from choice to choice without stopping at the nulls. 


5. The default separator line is a solid line on GUI-like NWS devices and dashes 
on NWS devices capable of underscoring mnemonics. 


6. Two leading blanks are shown in the first choice. This enables the pull-down 
menu text to line up with the choice named Edit. 


Example 2 


@1. Edit @@ 2. Browse @@ 3. Delete @@ 4. Print @@ 5. Exit @ 


Figure 15-10. Menu Bar with Numeric Selection With AS/400 System Padding 


Notes: 
1. The example is supported by all NWS devices. 


2. The user can select from numeric choices. Numbers are valid mnemonic 
characters. The AS/400 application includes the numbers in the choice text. 


3. The data stream indicates that the mnemonics are not underscored. 


4. The example shows how the AS/400 application pads choice text with nulls or 
blanks. | 
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NWS Single Choice Selection Field Presentation: Figure 15-11 on page 15-72 
and Figure 15-12 on page 15-72 show how the NWS presents single choice 
selection fields. 


Example 1 

@r@Choice 1 @ @r@Choice 2 text @ 
@REChoice 3 @ €@@ @ 
@r@Choice 5 - text@ G@r@Choice 6 @ 
@r@Choice 7 @ @@ @ 


Figure 15-11. Single Choice Selection Field With Indicators 


Notes: 
1. The at sign (@) indicates an attribute. 


2. The uppercase R character indicates a filled-in radio button and the lowercase r 
character indicates an empty radio button. 


3. On an NWS without GUl-like indicators, the slash (/) character is the default 
single choice indicator (choice is selected) and the period (.) character is the 
default single choice available indicator (choice is still available). 


4. Using a single- or double-digit selection field for non-GUI NWSs may be 
desired. 


5. Where desired, the AS/400 application can add null choices as separators. 
The cursor skips over null choices. Null choices do not have an indicator. 


6. Choice 5 in the figure is shown as unavailable. The default indicator and 
choice text attributes on a color NWS are blue. The default highlighting for both 
attributes on a monochrome NWS is normal (like available choices). The 
AS/400 application can instruct the 5494 to change the choice text to Choice 5 
- text to indicate unavailability on a monochrome NWS. 


7. You can instruct the 5494 to pad between choices with nulls (3 nulls between 
choices is shown) in the data stream. The Cursor Left and Cursor Right keys 
move the selection cursor from choice to choice without stopping at the nulls. 


8. When a user selects a choice, the radio button is filled-in. The indicator 
attribute and the choice text attribute are not modified as a result of the user 
selecting the choice. Any other selected choice is deselected (changed to an 
empty radio button). 


Example 2 


@.@1. Choicel@ @.@2. Choice 2 has very long choice text@ @.@3. Choice 3 text@ 
Figure 15-12. One Row Single Choice Selection Field With Indicators 


Notes: 


1. The example is supported by NWS types. It is not recommended for use with 
GUI-like NWSs; use the default radio buttons instead. 


2. For a single row selection field, the 5494 does not pad choices up to the 
textsize value. The AS/400 application can pad the choice text as desired. 


3. The user sees numeric selection; however, mnemonic selection is really used. 
All three NWSs support mnemonic selection. Numbers are valid mnemonic 
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characters. The AS/400 application includes the numbers in the choice text. 
The data stream indicates that mnemonics are not underscored. 


4. Null choices for a single row selection field are ignored. 


Single- and Double-Digit Numeric Selection Indicator Field: For single-digit 
numeric selection fields, the indicator field has the following states: 


Null State: The indicator field displays a space. (See the underscored 
position in Figure 15-13 on page 15-74.) The indicator field is null whenever: 


e The cursor is outside of the selection field and no choice is selected. 


e The cursor was on a selected choice and the Space Bar or Delete key was 
pressed to deselect the choice. Any cursor movement within the selection 
field causes the indicator field to change to the filled-in state. 


Filled-iIn State: The indicator field displays n, where nis a numeric character 
(0 through 9). The indicator field is filled-in when: 


e The cursor is outside of the selection field and the choice with n as the first 
choice text character is selected. 


e The cursor is on the choice with n as the first choice text character and the 
indicator field is not in the null state. 


For double-digit numeric selection fields, the indicator field has the following states: 


Null State: The indicator field displays two spaces. See the underscored 
positions in Figure 15-14 on page 15-74. The indicator field is null when: 


e The cursor is outside of the selection field and no choice is selected. 


e The user was on a selected choice and the user pressed the Space Bar or 
Delete key to deselect the choice. Any cursor movement within the 
selection field causes the indicator field to change to the filled-in state. 


Y% Filled-In State: The indicator field displays n with a space following it (rn ), 
where nis a numeric character (0 through 9). The indicator is ¥% filled when 
the indicator field is in the null or filled-in state and the user has pressed the 
numeric character (n) that matches the second digit of a choice beginning with 
a blank (or the numeric character matches the first digit of a choice). Any 
cursor movement within the selection field causes the indicator field to change 
to the filled-in state. 


Filled-In State: The indicator field displays nm or n with a space before it ( n), 
where rn and ™ are numeric characters (0 through 9). The indicator is filled-in 
when: 


e The cursor is outside of the selection field and the choice with nm or n with 
a space before it ( n) as the first two choice text characters is selected. 


e The selection cursor is on the choice with nm or n with a space before it 
( n) as the first two choice text characters and the indicator field is not in 
the null or % filled-in state. 


Figure 15-13 on page 15-74 shows how you can present a single-digit numeric 
selection field on a display device. 
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@ @1. Choice 1 @ 
@ @2. Choice 2 txttxt@ 
@ @8. Choice 3 @ 
~—6R @ 
@ @9. Choice 5 @ 


Figure 15-13. Single-Digit Numeric Selection Field 


Notes: | 
1. The example is not supported by GUI-like NWSs. 
2. The indicator field is underscored. 


3. The numeric digit, period (.) character, and optional space are not part of the 
choice text, but are included relative to the textsize value. 


4. If single-digit numeric selection is a specified option, the maximum choice text 
size (depending on optional space) is 2 or 3 characters less than the textsize 
value. 


5. The example requires the same screen space as an equivalent GUI selection 
field with radio buttons. The inbound cursor address is also the same. 


6. The single-digit indicator field is null. This is true if the cursor was outside of 
the field and no choice was selected. 


Figure 15-14 shows how you can present a multiple column double-digit numeric 
selection field on a display device. 


@ 3@ 1. Choice 1 @@@2. Choice 2 @ 
@ @3. Choice 3 @@ @ 4. Choice 4 @ 
@ @ Ce @ @ 
@ @20. Choice 7 @@ @21. Choice 8 @ 


Figure 15-14. Multiple Column Double-Digit Numeric Selection Field 


Notes: 
1. The example is not supported by GUI-like NWSs. 
2. The 2-character indicator field is underscored. 


3. The indicator field has a 3 indicating that either the cursor is outside the 
_ selection field and choice 3 is selected or a selection cursor is positioned on 
choice 3. 


4. The example requires that 1 column is added to the left side as compared to a 
single choice selection field with radio buttons (only one indicator position is 
used on subsequent columns). The inbound cursor address is the same as a 
2-column selection field with radio buttons. 


Figure 15-15 on page 15-75 shows how you can present a single choice selection 
field without indicators on a display device. 
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@Choice 1 @@Choice 2 text @ 
@Choice 3 @@Choice 4 @ 
@Choice 5 text @@Choice 6 @ 
@ @@ @ 
@Choice 9 @@Choice 10 text @ 


Figure 15-15. Single Choice Selection Field Without Indicators 


Notes: 
1. The example is supported by all NWSs. 


2. When a user selects a choice, the choice text attribute is changed to show the 
users selection. In the figure, Choice 2 is selected. 


NWS Multiple Choice Selection Field Presentation: Multiple choice selection fields 
are similar to the single choice selection fields shown earlier. The exception is that 
multiple choice selection fields have different indicators. Multiple choices can be 
selected, and there is no single- or double-digit multiple choice selection field. 
Multiple choice selection field examples are shown in Figure 15-16 and in 

Figure 15-17. 


Example 1 


@c@Choice 1 @ @C@Choice 2 @ 
@ @ @ @c@Choice 4 text@ 
@C@Choice 5 @ @c@Text choice 6@ 


Figure 15-16. Multiple Choice Selection Field With Indicators 


Notes: 


1. The uppercase C character indicates that a check box is checked and the 
lowercase c character indicates that the check box is empty. For an NWS that 
cannot create GUl-like indicators, an underscored slash (/) character is the 
default multiple choice selection indicator. An underscored blank (_) is the 
default choice indicator attribute. 


2. Mnemonic selection is shown (not all choices are required to have a 
mnemonic). 


3. When a user selects a choice, the check box is checked. The indicator 
attribute and the choice text attribute are not modified as a result of the user 
selecting the choice. 


Example 2 

@Choice 1 @ @Choice 2 text @ 
@Choice 3 @ €@Choice 4 @ 
@Choice 5 txt @ €@Choice 6 @ 
@ @ @ @ 
@Choice 9 @ @ @ 


Figure 15-17. Multiple Choice Selection Field Without Indicators 
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Notes: 
1. The example is supported on all NWSs. 
2. The example shows padding of two nulls between choices. 
3. When a user selects a choice, the choice text attribute is aenee to show the 
selection made by the user. . 


NWS Single Choice Selection List Presentation: Single choice selection lists are 
similar to single choice selection fields. The exception is that a vertical scroll bar 


.can be presented beside the selection field. Single choice selection list 


presentation examples are shown in Figure 15-18 and Figure 15-19. 


Example 1 

@r@Choice 1 @ @r@Choice 2 text GC#E@ 
@REChoice 3 @ @6@6 CC#E 
@r@Choice 5 - text@ @r@Choice 6 CCFO 
@r@Choice 7 @ @@ Qe0#E@ 


Figure 15-18. GUI-like Single Choice Selection List With a Scroll Bar 


Notes: 
1. The example is supported only by GUI-like NWSs. 


2. The pound sign (#) indicates part of a GUI scroll bar. A single choice selection 
list does not require a scroll bar. 


3. The example shows radio button indicators. The advantage of presenting 
indicators is that the screen layout is the same between GUI NWSs and 
non-GUI NWSs using single-digit numeric selection. 


4. A selection field that can be scrolled should have at least five rows for optimal 
presentation. However, three rows are required. 


5. The AS/400 application can add null choices as separators. 


6. In the data stream, you can instruct the 5494 to pad between choices with 
nulls. 


7. When a user selects a choice, the radio button is filled-in. Any previously 
selected choice is deselected. 


Example 2 

@ @ 1. Choice 1 @@AG 
@ @ 2. Choice 2 txttxt@G*@ 
@ @ 3. Choice 3 @@x@ 
@ @ @@:@ 
@ @10. Choice 5 @@:@ 
@ @11. Choice 6 @@:@ 
@ @13. Choice 7 @@VE@ 


Figure 15-19. Double-Digit Numeric Selection List With a Scroll Bar 
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Notes: 
1. The example is not supported by GUI-like NWSs. 


2. The example shows default character equivalents of a scroll bar. The scroll bar 
is optional. 


3. The 2-character indicator field is underscored. 


4. The example requires that one column is added to the left side as compared to 
a single choice selection field with radio buttons. 


NWS Multiple Choice Selection List Presentation: Multiple choice selection lists 
are very similar to multiple choice selection fields. The exception is that a vertical 
scroll bar can be presented beside the selection field. A multiple choice selection 
list presentation example is shown in Figure 15-20. 


@ @Choice 1 @@AG 
@/@Choice 2 @@:@ 
@/@Choice 3. @@:@ 
@ @Text - choice 40@*@ 
@ @ @e*@ 


@/@Text - choice 6@@V@ 


Figure 15-20. Non-GUI Multiple Choice Selection List With Indicators 


Notes: 


1. The example is supported by all NWSs, but is not recommended for GUI-like 
NWSs (check boxes and GUI scroll bars should be used instead). 


2. The scroll bar is optional. 

3. Indicators are optional. 

4. Mnemonic selection can be used. 
NWS Selection Field (List) in a Pull-Down Menu Presentation: Any type of single 
or multiple selection field (or list) can be placed in a pull-down menu. A pull-down 


menu can contain more than one selection field. Figure 15-21 shows two selection 
fields in a pull-down menu. 


@ Edit@@Browse@@Del ete@@Exit@ 


@:@Choice 1 @@Choice 2 @ @:@ 
@:@Choice 3 @@Choice 4 @ @:@ 
@:@Choice 5 @@Choice 6 @ @:@ 
@:@Choice 7 @@ @ @:@ 
@:@ @:@ 
@:@ @Choice 1 GAG: 
@:@/@Choice 2 @:0:@ 
@:@/@Choice 3 @:0:@ 
@:@ @Text - choice 4 @«@:@ 
@:@/@Text - choice 5 G@VG@:@ 
@ @ 


Figure 15-21. Pull-Down With a Selection Field and Selection List 
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Notes: 


q 


3. 
4. 


The example shows a 2-column single choice selection field without indicators 
and a multiple choice selection list with indicators. 


This type of presentation is not recommended, but it is an example of the 
different types of single and multiple selection fields (or lists) in a pull-down 
menu. The AS/400 application positions the pull-down menu and the selection 
fields inside a window. 


. The default separator line and default pull-down menu borders are solid lines 


on GUIl-like NWSs. 
The menu bar and pull-down menu window are shown starting at column 1. 


The example shows how the indicator attribute (or the leading choice text 
attribute) can overwrite the second left border attribute. Writing the ending 
choice text attribute or ending scroll bar attribute is suppressed if it preety 
overlaps the first right border attribute. 


. If a pull-down browse menu is desired, the leftmost and rightmost choices can 


be defined as leftmost and rightmost in the choice text minor structure. 


NWS Push Button Presentation: Figure 15-22, Figure 15-23 on page 15-79, and 
Figure 15-24 on page 15-79 show examples of push button selection field 
presentations. 


Example 1 


@ Enter=OK @@ F12=Cancel @ 


Example 2 


@<Enter=0K>@@<F12=Cancel>@ 


Figure 15-22. Two Push Button Selection Fields With 4-Character Spacing 


Notes: 


I 
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The example has 4 positions between the push button text. You can add more 
space between the choices by instructing the 5494 to pad between choices. 
Also, the AS/400 application can pad choices. 


. Example 1 shows a GUI push button indicating that a box is created around the 


choice text (which includes the padded blanks surrounding the choice text). 
The box is created between rows and columns of characters. 


. Example 2 shows a non-GUI push button indicating that characters are used 


for the push button. The default push button characters are the less than sign 
(<) and the greater than sign (>). 


Notice that the two different types of selection fields require the same amount 
of screen space. 


. The padded blanks or added push button characters are included when 


truncating a choice to the specified textsize value. Therefore, the textsize value 
must be at least 2 positions greater then the length of the longest text choice. 


5. For any selection field with a single row, the 5494 does not pad choices to the 
textsize value. 


6. The examples show mnemonic selection, which are supported by GUI-like 
NWSs and NWSs that are capable of mnemonic underscoring. 


Example 1 
@ Enter=OK @ F12=Cancel @ 
Example 2 


@<Enter=O0K>@<F12=Cancel>@ 


Figure 15-23. Two Push Button Selection Fields With 3-Character Spacing 


Notes: 


1. The example has 3 positions between push button text. The leading choice 
text attribute overwrites the previous ending choice text attribute. 


2. Example 1 shows a GUI box that is created around the choice text (which 
includes the padded blanks surrounding the choice text). 


3. Example 2 shows a non-GUI push button that uses characters. 


Notice that the two different types of selection fields require the same amount 
of screen space. 


Example 1 
@Enter=OK@@F12=Cancel@ 
Example 2 


@Enter=OK@@F12=Cancel@ 


Figure 15-24. Two Push Button Selection Fields With 2-Character Spacing 


Notes: 
1. The example has 2 positions between push button text. 
2. Example 1 shows a GUI box that is created around the choice text. 
3. Example 2 shows a non-GUI with no push button indicator characters. 
Notice that the two different types of selection fields require the same amount 
of screen space. 


Choice Attributes: All selection field entries have a leading choice text attribute 
and an ending choice text attribute. The leading choice text attribute is used to 
indicate the choice state, if no indicators are used (available, selected, or 
unavailable). It is modified when the selection cursor is on the choice. 


Optionally, selection field entries can have an indicator attribute and an indicator 
that comes before the leading choice text attribute and choice text. 


If the selection field has a scroll bar, the ending choice text attribute of the 
rightmost column of choices is overwritten by the leading scroll bar attribute. An 
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ending scroll bar attribute is written after the scroll bar character. Figure 15-25 
shows how choice attributes are specified. 


@choice text@ choice with no indicators 
@<push button>@ push button choice 
@i@choice text@ choice with indicator 
@ @4. choice tx@ Single digit choice 
@ @12. choice t@ double digit choice 
@choice text@#@ choice with a scroll bar | 
@i@choice text@#@ choice with indicator and scroll bar 
@ @4. choice tx@#@ Single digit choice and scroll bar 
nT choice 1 double digit choice and scroll bar 
I! || || --- ending scroll bar attribute 
| || | ----- ending choice text attribute or leading scroll bar attribute 
|| [tttttttttttt----- choice text 
|| ------------------ leading choice text attribute or selection cursor attribute 
| -------------------- indicator attribute (to the left of each choice or single-digit) 
2 -------------------- indicator attribute for a double digit select field choice 
@ - display attribute 
j - indicator to the left of choice 
# - scroll bar character 


Figure 15-25. Choice Attributes 


Indicator Attributes for Selection Fields: \f the selection field has indicators to the 
left of each choice, or the selection field is a single- or double-digit numeric 
selection, the leftmost display attribute is the indicator attribute; otherwise, this 
selection field does not have an indicator attribute. 


The default indicator attributes for a selection field with indicators to the left of each | 
choice text are: 


Normal (X'20') For a GUI-like monochrome NWS with available or selected 
choices. 


Green (X'20') For a GUl-like color NWS with available or selected choices. 
Normal (X'20') For a GUI-like monochrome NWS with an unavailable choice. 
Green (X'20') For a GUl-like color NWS with an unavailable choice. 


Underscore (X'24') 
For a non-GUI monochrome NWS with available or selected 
multiple choice selection field or list. 


Green Underscore (X'24') 
For a non-GUI color NWS with available or selected choice 
multiple choice selection field or list. - 


Normal (X'20') For a non-GUI monochrome NWS with an unavailable choice. 
Green (X'20') For anon-GUl color NWS with an unavailable choice. 


Normal (X'20') For a non-GUI monochrome NWS with an unavailable or selected 
choice within a single choice selection field or list. 


Green (X'20') For anon-GUI color NWS with an unavailable or selected choice 
within a single choice selection field or list. 


~ 
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The default indicator attributes for a single- or double-digit selection field are: 


Underscore (X'24') For the first choice (monochrome display). 
Green Underscore (X'24') For the first choice (color display). 

Normal (X'20') For subsequent choices (monochrome display). 
Green (X'20') For subsequent choices (color display). 


Cursor Attributes for Selection Fields: The display attribute that comes before the 
choice text is the leading choice text attribute. If the selection cursor is on this 
choice, the leading choice text attribute is overwritten by the selection cursor 
attribute. 


The selection cursor is a type of cursor that is used for making choice selections. 
The selection cursor is active within selection fields. The text cursor is not 
displayed within a selection field. 


It is recommended that you use only one of the following methods for highlighting 
selected choices. The 5494 default fields conform to the following methods for 
selected choices: 


e Selection indicators are placed to the left of each choice. 


¢ Single- or double-digit indicator fields are used for single- or double-digit 
numeric selections. 


e The leading choice text attribute is used, if no indicators are used. 


The default selection cursor attribute is described as follows: 

Reverse image (X'21') | For an available choice on a monochrome display. 
Green Reverse (X'21') | For an available choice on a color display. 

Reverse Image (X'21') |For an unavailable choice on a monochrome display. 
Blue Reverse (X'3B') For an unavailable choice on a color display. 


Reverse Image (X'21') For a selected choice, if there is an indicator attribute 
on a monochrome display. 


Green Reverse (X'21') | For a selected choice, if there is an indicator attribute 
on a color display. 


Intense Reverse (X'23') For a selected choice, if indicator attributes are not 
used on a monochrome display. 


White Reverse (X'23') | For a selected choice, if indicator attributes are not 
used on a monochrome display. 


The selection cursor attribute values can be changed with the choice presentation 
attributes minor structure. 


Leading Choice Text Attribute for Selection Fields: \f the selection cursor is not on 


a choice, the default leading choice text attributes are partially determined by the 
use of the indicators to the left of the choices. 
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The default leading choice text attributes can be changed on a field-to-field basis by 
using the choice presentation display attributes minor structure. The default leading 
choice text attributes are: 


Normal (X'20') — For a choice that aati on a monochrome display. 
Green (X'20') For a choice that is available on a color display. 

Normal (X'20') |= For a choice is that unavailable on a monochrome display. 
Blue (X'3A') For a choice that is unavailable on a color display. 


Normal (X'20') — For a selected choice, if indicator attributes are used on a 
monochrome display. 


Green (X'20') For a selected choice, if indicator attributes are used on a color 
display. 


Intensify (X'22') For a selected choice, if indicator attributes are not used on a 
monochrome display. 


White (X'22') For a selected choice, if indicator attributes are not used ona 
color display. 


Ending Choice Text Attribute for Selection Fields: A choice text termination 
attribute is written after the choice text. This attribute is normal display with a value 
of X'20'. If the ending choice text attribute exactly overwrites the first right border 
attribute of the top window border, the ending choice text attribute is not written. 


Leading Scroll Bar Attribute for Selection Fields: The attribute immediately to the 
left of the scroll bar, if a scroll bar is present, is the leading scroll bar attribute. The — 
leading scroll bar attribute overwrites the ending choice text attribute of the 
rightmost column of choices. The default leading scroll bar attributes can be 
changed on a field-to-field basis by using the scroll bar indicators minor structure. 


The default leading scroll bar attributes are for GUI-like NWSs and non-GUI NWSs, 
and are described as follows: 


Intensify (X'22') On a monochrome GuUI-like display. 
White (X'22') On a color GUl-like display. 
Reverse (X'21') On a monochrome non-GuUI-like display. 


Reverse White (X'23') Ona color non-GUl-like display. 


Ending Scroll Bar Attribute for Selection Fields: An ending scroll bar attribute is 
written after the scroll bar. This attribute is normal display (X'20'). If the ending 
scroll bar attribute exactly overwrites the first right border attribute of the top 
window border, the ending scroll bar attribute is not written. 


Choice Selection Indicators for Selection Fields: \f indicators are presented to the 
left of each non-null choice, the 5494 uses the choice selection indicators to 
indicate which choices have been selected. 


The following indicators are used within single-choice selection fields: 


Period (.) For an unselected choice. 
Empty Radio Button For an unselected choice. 
Slash (/) For a selected choice. 


Filled-in Radio Button For a selected choice. 
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The indicators can be changed on a field-by-field basis by using the choice 
indicator minor structure. The following indicators are used within multiple-choice 
selection fields: 


Space For an unselected choice. 

Empty Check Box For an unselected choice. 

Slash (/) For a selected choice (the country-specific selection 
character is used instead of the slash (/) character, if 
applicable). 


Filled-In Check Box — For a selected choice. 


Default Push Button Characters for Selection Fields: The default push buttons can 
be changed on a field-by-field basis by using the choice indicator minor structure. 
The default push button characters on displays that are not capable of creating 
boxes (or when boxes are not used for displays capable of creating them) are the: 


Less Than Sign (<) For left choice text. 
Greater Than Sign (>) For right choice text. 


When an NWS display device creates a box around push button text, the push 
button characters are ignored and replaced with nulls. The choice text is bound by 
one null on each side to keep push buttons the same size. 


Choice Text for Selection Fields: The 5494 writes the choice text that is specified 
in the choice text minor structures. 


The 5494 appends a blank area after the choice text, which consists of trailing 
spaces, to clear the remaining choice text area (if necessary). 


Scroll Bar Characters for Selection Fields: The default scroll bar characters for a 
display without GUI-like scroll bar characters are: 


A For a top scroll bar character. 
V For a bottom scroll bar character. 
Colon (:) For empty scroll bar positions. 
Asterisk (*) For slider scroll bar positions. 


The following scroll bar indicator settings can be changed on a field-by-field basis 
by using the scroll bar indicators minor structure. The default scroll bar characters 
for a model with GUl-like scroll bar characters are: 


Up Arrow For a top scroll bar character. 
Down Arrow For a bottom scroll bar character. 
Filled-in Block For slider scroll bar positions. 


Blank With Vertical Borders 
For empty scroll bar positions. 


The 5494 uses totalrows values that can be scrolled, sliderpos values, and row 
parameter values from the define selection field major structure to determine where 
a Slider is to be placed within the scroll bar shaft and how large the slider is going 
to be. 


It is recommended that selection fields with a scroll bar have 5 or more rows. For 


an NWS, when a scroll bar with 3 or 4 rows is presented, the top and bottom scroll 
bar characters are not displayed; only the shaft is visible. 
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Using Selection Fields: When the cursor enters a selection field, a selection cursor 
is created and the text cursor is made invisible. If the selection field is a single- or 
double-digit selection field, the indicator field is filled with the numeric character or 
characters. 


Choice Selection: There are several ways to make a choice selection within a 
selection field, depending on the type of selection field and the AS/400 application 
user defined characteristics of the field. 


There are three states for each choice, they are: 


e Available 
e Selected 
e Unavailable. 


lf a user attempts to select an unavailable choice, an operator error is returned to 
the user. 


The 5494 changes the appearance of a choice whenever a choice is selected, 
changing it from available status to selected status. When a choice is deselected, 
the 5494 changes it from selected status to available status. 


When one of the following types of choices is selected in a single choice selection 
field, a previously selected choice is automatically deselected. Descriptions of the 
three basic types of choices are: | 


Choice With No Indicator Attributes: Selecting a choice results in the 
leading choice text attribute being changed to the selected value. Deselecting 
a choice results in the leading choice text attribute being changed to the 
available value. 


Choice With Indicators to the Left of Each Choice: Selecting a choice 
results in the indicator being changed to the selected value. Deselecting a 
choice results in the indicator being changed to the available value. 


Choice With Single- Or Double-Digit Numeric Selection: Selecting a choice 
results in the single- or double-digit indicator field being filled-in. Deselecting a 
choice results in the single- or double-digit indicator field being nulled. 


Cursor Selection: The selection of a choice by moving the selection cursor onto it 
and pressing the Enter key. Cursor selection is enabled when the selection cursor 
is activated within an auto-select selection field. 


Mnemonic Selection: The selection of a choice by entering a mnemonic character 
associated with that choice. Numeric characters are valid as mnemonics. When 
numeric characters are used as mnemonics, the user sees what looks like numeric 
selection. A choice is selected by entering the number associated with that choice 
(this is not the same as single- and double-digit numeric selection). 


When the user presses a mnemonic (numeric) character within a selection field, the 
5494 searches for a choice with a mnemonic (numeric) value that matches the 
character entered. When a match is found, the selection cursor is moved to the 
choice and the associated choice is selected. 


While using mnemonic selection, the 5494 does not distinguish between uppercase 
and lowercase characters. 
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Single- and Double-Digit Numeric Selection: Single- and double-digit numeric 
selection is supported only by NWS non-GuUls. 


When the user presses a numeric character (0 through 9) while in a single- digit 
numeric selection field, the 5494 processes it as follows: 


e If anumeric character matches the digit of a choice that can be selected with a 
cursor, the selection is moved to the choice. The choice is selected and the 
selection indicator is filled-in (n where n is the numeric character). If there is no 
match, an operator error is returned to the user. 


When the user presses a numeric character (0 through 9) while in a double-digit 
numeric selection field, the 5494 processes it in one of two ways: 


e When a double-digit indicator field is null or filled-in and: 


— lf the numeric character matches the second digit of a choice that accepts 
a cursor beginning with a blank, the selection cursor is moved to the 
choice. The choice is selected, and the selection indicator is set to % 
filled-in (n ) where nis the numeric character. 


— If the numeric character matches the first digit of a choice that accepts a 
cursor, the selection cursor is moved to the lowest numbered matching 
choice and the selection indicator is set to % filled-in (n ). 


— A zero is ignored (unless a match is found). Zero is a valid choice number. 


e When a double-digit indicator field is % filled-in (the user has typed one valid 
numeric character) and: 


— lf the numeric character matches the second digit of a choice that accepts 
a cursor and the first digit of the choice matches the number in the first 
position of the indicator field, the selection cursor is moved to the choice, 
the choice is selected, and the selection indicator is filled-in (nm where n 
and m are numeric characters). 


— lf the numeric character matches the second digit of a choice that accepts 
a cursor beginning with a blank, the selection cursor is moved to the lowest 
numbered matching choice, the choice is selected, and the selection 
indicator remains % filled-in (n where nis the numeric character). 


— lf the numeric character matches the first digit of a choice that accepts a 
cursor, the selection cursor is moved to the lowest numbered matching 
choice and the selection indicator remains % filled-in (n where n is the 
numeric character). 


Slash (/) Selection and Country-Specific: Slash (/) selection is the selection of a 
choice by entering a slash (/) character when the selection cursor is positioned on 
the desired choice. You can use slash (/) selection within single choice or multiple 
choice selection fields. 


A country-specific selection character can be specified. If one is specified, it 
functions like slash (/) selection. You can use country-specific selection within 
_ single choice or multiple choice selection fields. 


Space Bar Selection: Space bar selection is the selection of a choice by typing a 
space bar character when the selection cursor is positioned on the desired choice ( 
as long as that choice has not been selected). The selection of this choice is 
canceled if the choice has already been selected when the Space Bar key is 
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pressed. You can use space bar selection within single choice or multiple choice 
selection fields. 


Pointer Device Selection: A PWS or an NWS that is using a pointer device 
enables pointer selection. Whenever the user selects a choice with a pointer 
device, the selection is mapped into a space bar selection. 


Changing a Selection: For a single choice selection field, a selection is changed 
by selecting a different choice. In a multiple choice selection field, a choice must 
be explicitly selected or deselected. | 


In a single-choice or multiple-choice selection field, a selection can be deselected 
by pressing the Space Bar or Delete key while the selection cursor is positioned on 
the selected choice. In a single- or double-digit numeric selection field, the 
indicator field is set to null when a user deselects a choice. 


Scrolling the Choice List: A selection list that can be scrolled consists of displayed 
choices and additional choices stored on the AS/400 system. The 5494 manages 
the presentation and selection of displayed choices. The AS/400 application 
recognizes a field scroll request (from the attention identifier [AID] value and cursor 
address that is returned) and responds by presenting the previous or following set 
of selection field choices. 


Cursor Up: When the Cursor Up key is pressed and the selection cursor is on a 
choice that is defined as a top choice on the screen, cursor-sensitive scrolling can 
be used. The 5494 invokes the simulation of the Roll Down key by locking the 
keyboard and returning the roll down AID value of X'F4' and the field data to the 
AS/400 application. The selection cursor is not moved. 


Cursor Down: When the Cursor Up key is pressed and the selection cursor is on a 
choice defined as a bottom choice on the screen, cursor-sensitive scrolling can be 
used. The 5494 invokes the simulation of the Roll Up key by locking the keyboard 
and returning the roll down AID value of X'F5' and the field data to the AS/400 | 
application. The selection cursor is not moved. 


Cursor Left: When the Cursor Left key is pressed and the selection cursor is on a 
choice defined as a left choice on the screen, cursor-sensitive scrolling can be 
used. The 5494 locks the keyboard and returns the roll left AID value of X'D9' 
and the field data to the AS/400 application. The selection cursor is not moved. 


Cursor Right: When the Cursor Right key is pressed and the selection cursor is on 
a choice defined as a right choice on the screen, cursor-sensitive scrolling can be 
used. The 5494 locks the keyboard and returns the roll right AID value of X'D9' 
and the field data to the AS/400 application. The selection cursor is not moved. 


Pointer Device Scroll Bar Interaction: A PWS or an NWS that uses a pointer 
device can generate roll requests using the scroll bar. 


When a NWS user uses a pointer device in the scroll bar shaft above the slider or 
on the top arrow, a roll down AID is returned. The roll up AID is returned if the 
pointer is below the slider or on the bottom arrow. 


A PWS responds with roll up and roll down AIDs based on standard pointer device 
interaction with the scroll bar. This is also true when a user drags and drops the 
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slider to a user specified scroll increment (using a non-zero scroll increment in the 
inbound data). 


The (text) cursor is optionally moved to the location in the scroll bar. If the cursor 
is not in the selection field, the cursor is moved to the scroll bar. If the (selection) 
cursor is in the selection field, the cursor is not moved. The cursor is moved 
because a screen could have multiple scroll bars and the cursor location can be 
used to determine which data is going to be scrolled. 


Editing Keys Used in Selection Fields: The following describes how the 5494 
processes edit keys within the selection field presentation area, as well as the 
interaction of edit keys with selection fields when used outside a field. 


Field Advance: Field Advance (the Tab key) and Field Exit cause the cursor to 
move to the next field. If the next field is a selection field, a selection cursor is 
created on the first choice that accepts a cursor. If the next field is a single- or 
double-digit numeric selection field, the indicator field is filled-in with the numeric 
character or characters. 


When using Field Advance or Field Exit to exit a selection field, the cursor exits 
from the first choice, independent of where the selection cursor is located within the 
_ selection field. 


Field Backspace: Field Backspace (Tab Backward key) causes the cursor to move 
to the previous field. If the previous field is a selection field, a selection cursor is 
created on the first choice that accepts a cursor. When the Field Backspace is 
used to exit a selection field, the cursor exits from the first choice, independent of 
where the selection cursor is located within the selection field. 


Field Exit: Functions the same as Field Advance. 
Field Plus: Functions the same as Field Advance. 
Field Minus: Functions the same as Field Advance. 


Delete: Deselects a choice if another choice is selected. The cursor does not 
move. If the selection field is a single- or double-digit selection field, the indicator 
field is set to null when the choice is selected. 


Insert: Sets the insert mode to on or off (toggle function). The insert mode has no 
effect on how keystrokes are processed within selection fields. 


Erase Input: Deselects selection field choices when the selection field MDT is set 
to on. The selection field MDT is not affected by this function. 
Auto-enter-on-deselect is processed at this time if it has been specified for any field 
that has the field MDT set and has selected choices. 


REMOVE GUI SELECTION FIELD Structured Field 

It is recommended that you use this structured field with caution. The REMOVE 
GUI SELECTION FIELD structured field can be used to delete a GUI selection field 
construct and the associated GUI scroll bar construct. For an PWS device, a 
selection field and the associated scroll bar (created by a define selection field 
major structure) are GUI constructs. For GUlI-like NWSs, this command works with 
push buttons that have push button boxes created around them. 
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The current display address must be the same as the selection field that was 
created by a define selection field major structure. A PWS attempts to locate a 
match between the current display address and a GUI selection field. When a 
match is found, the GUI construct is deleted, but the display screen is not cleared. 


~ For a GUI-like NWS, this command works with a push button box that is created 


around push button choice text. When the 5494 locates a match between the push 
button selection field and the push button boxes, the push button boxes are 
removed. 


It is important to have a CLEAR FORMAT command or SOH order follow the 
REMOVE GUI SELECTION FIELD structured field in the same display data stream. 


The remove GUI selection field major structure must follow the WDSF order (See 
“WRITE DATA Structured Field” on page 15-93). 


Table 15-24 describes the format for the remove GUI selection field major 
structure. 


Table 15-24. Format for Remove GUI Selection Field Major Structure 


Byte Name Value Description 

1-2 Major 6 Length of structured field in bytes (including 
Length length bytes). 

3 Class X'D9g! Class of structured field. 

4 Type X'58' Type of structured field. | 

5 Flag Byte Bits 0-7 Reserved (must be set to off). 

6 Reserved X'00' Reserved (must be set to zero). 


DEFINE SCROLL BAR FIELD Structured Field 

The DEFINE SCROLL BAR FIELD structured field is used to define a vertical or 
horizontal scroll bar field. The vertical scroll bar is similar to the scroll bar that can 
be defined with selection fields. A scroll bar field has the flexibility of binding any 
type of data, not just selection field choices. No keyboard functions are defined for 
a scroll bar field. 


A PWS or NWS that uses a pointer device responds with roll up, roll down, roll left 
(X'D9') and roll right (X'DA') AlDs when the user uses a pointer device on a 
scroll bar. The user must be interacting within a scroll bar shaft, on the arrows, or 
performing a slider drag and drop action. 


When a roll AID is sent as the result of a user pointing the device on a scroll bar, 
the text cursor is optionally moved to the location within the scroll bar. This is done 
because the screen can have multiple scroll bars and the cursor location is used to 
determine which data is to be scrolled. 


When defining a scroll bar, the scroll bar position is relative to the upper left scroll 
bar attribute and determined by the current display address which is typically set 
with the SBA order. 


On a PWS, the scroll bar is a GUI construct. This means that screen data is 
covered by the GUI construct. Simply writing over the scroll bar does not remove 
the GUI construct (for example, if you issue an SBA order followed by characters). 
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A create window structured field creates a GUI window that can write over part or 
all of a GUI scroll bar. Use the following commands to remove a GUI scroll bar 
created by a define scroll bar field major structure: 


e CLEAR UNIT command 

¢ CLEAR UNIT ALTERNATE command 

e RESTORE command 

e RESTORE PARTIAL SCREEN command 

¢ REMOVE GUI SCROLL BAR FIELD structured field 
e REMOVE ALL GUI CONSTRUCTS structured field. 


The GUI construct requires equal or less space on the display screen than the 
character equivalent of a scroll bar. 


DEFINE SCROLL BAR Field Major Structure: The define scroll bar field major 
structure must follow the WDSF order (See “WRITE DATA Structured Field” on 
page 15-93). 


Table 15-25 describes the format for the define scroll bar field major structure. 


Table 15-25. Format of Define Scroll Bar Field Major Structure 


Byte Name Value Description 
1-2 Major >14 Length of structured field in bytes (including 
Length length bytes). 
Class X'D9g! Class of structured field. 
4 Type X'53! Type of structured field. 
Flag Byte Bits 0 Vertical scroll bar is set to off and horizontal 
scroll bar is set to on. 
Bit 1 The cursor is moved to the scroll bar on a 
pointer device scroll bar interaction if set to on. 
Bits 2-6 - Reserved (must be set to off). 
Bit 7 Field MDT. 
6 Reserved X'00' Reserved (must be to zero). 
7-10 TotalRows The specified value is the total number of rows 
or TotalCols of data that can be scrolled that are available to 
That Can the AS/400 application. This is for a vertical 
Be Scrolled scroll bar or columns for a horizontal scroll bar. 
11-14 SliderPos The number of rows or columns of data that can 


be scrolled that are available to the AS/400 
application user above the first row or column on 
the display screen. 


15 Rows or >2 or >6 Number of screen rows a vertical scroll bar can 
| Columns occupy (maximum number of rows allowed 
depends on the display screen size). The 
number of columns a horizontal scroll bar can 
occupy (including the leading and trailing 
horizontal scroll bar attributes). 


16-n Minor Optional minor structures. 
Structures | 
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DEFINE SCROLL BAR Field Major Structure Parameters: The scroll bar field 
major structure parameters are defined as follows: 


Vertical or Horizontal: The flag that defines the orientation of a scroll bar. 


Move Cursor to Scroll Bar: The cursor is moved to the scroll bar on a pointer 
device scroll bar interaction if set to on. If multiple scroll bars are on a display 
screen, the cursor location can be used to determine which data to scroll. 


Field MDT: The scroll bar field MDT (as in entry fields) can be initially set on 
by the AS/400 application. The 5494 or PWS only sets the field MDT when a 
pointer device establishes a scrolling request. 


TotalRows or Cols: The totalrows parameter defines the total number of rows 
available to the AS/400 application for a vertical scroll bar or columns for a 
horizontal scroll bar. For data that can be scrolled, this parameter is used to 
determine the slider size in the scroll bar. 


SliderPos: The sliderpos parameter determines the position of the top of the 
slider (or leftmost position of the slider for a horizontal scroll bar) within the 
scroll bar. The sliderpos parameter defines the total number of rows for a 
vertical scroll bar or number of columns for a horizontal scroll bar, above or to 
the left of the slider. The sliderpos and totalrows parameters enable the 5494 
to determine the size of the space before the slider, the size of the slider, and 
the size of the space after the slider in the scroll bar. 


If the sliderpos value and the rows and columns values are greater than the 
totalrows or columns value, a negative response is returned. 


Rows or Columns: The rows or columns parameter defines the number of 
screen rows to be used to present a vertical scroll bar (including the top and 
bottom scroll bar characters). The minimum value is 3 for a vertical scroll bar 
and 7 for a horizontal scroll bar. For a horizontal scroll bar, the rows or 
columns parameter defines the number of screen columns to be used to 
present a horizontal scroll bar (including the leading attribute, the left scroll bar 
character, the right scroll bar character, and the trailing attribute). 


Vertical Scroll Bar Field Presentation Area: A vertical scroll bar field presentation 
area that is a 3-column wide rectangular area. The first column contains the scroll 
bar attribute. The default scroll bar attributes are the same for a scroll bar ina 
selection field. See “Leading Scroll Bar Attribute for Selection Fields” on page 
15-82. The second column contains the scroll bar characters. The default scroll 
bar characters are the same for a scroll bar in a selection field (See “Scroll Bar 
Characters for Selection Fields” on page 15-83). The scroll bar attributes and scroll 
bar characters can be customized by using the scroll bar indicator minor structure. 
See “Scroll Bar Indicators Minor Structure” on page 15-91. The third column 
contains a normal display attribute value of X'20'. The rows and columns 
parameter defines the number of rows in a rectangular area. A minimum of 5 rows 
are recommended because no top or bottom scroll bar characters are presented for 
3- or 4-row scroll bars. 


Horizontal Scroll Bar Field Presentation Area: A horizontal scroll bar field 
presentation area is 1 row specified by the rows and columns parameter. The first 
column contains the scroll bar attribute. The default scroll bar attributes are the 
same for a scroll bar in a selection field. See “Leading Scroll Bar Attribute for 
Selection Fields” on page 15-82. The second column contains the left horizontal 
scroll bar character. The following default scroll bar characters are used for a 
non-GUI-like NWS: 
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Less Than Sign (<) Left scroll bar character. 
Greater Than Sign (>) Right scroll bar character. 
Hyphen (-—) Empty scroll bar shaft position. 
Asterisk (*) Slider scroll bar shaft position. 


The following default scroll bar characters are used for a GUlI-like display device. 


Left Arrow Left scroll bar character (default). 
Right Arrow Right scroll bar character (default). 
Filled-in Block Slider scroll bar shaft position. 


Blank with Horizontal Borders Empty scroll bar shaft position (default). 


Scroll bar attributes and scroll bar characters can be customized by using the scroll 
bar indicator minor structure. See “Scroll Bar Indicators Minor Structure” for more 
information. The trailing attribute contains a normal display attribute value of 
X'20'. The rows and columns parameter defines the number of columns, including 
the leading attribute, left scroll bar character, shaft characters, right scroll bar 
character, and trailing attribute. 


Scroll Bar Field Rules and Restrictions: The scroll bar field address is the current 
display address in effect when the structured field is received by the 5494. This 
address defines the upper-left position of the scroll bar field presentation area 
(upper-left scroll bar attribute). The current display address is not modified as a 
result of scroll bar field processing. 


The following rules must be followed when defining a scroll bar field, or a negative 
response is returned: 


e The scroll bar field presentation area must fit within the display screen. 


e Resequencing and scroll bar fields cannot be used together for the same 
display device. 


¢ All fields, including scroll bar fields, must be defined in descending left-to-right 
order on the screen. Other entry, selection, or scroll bar fields can be 
subsequently defined following a scroll bar field. 


e The scroll bar field presentation area must not overlap the presentation area of 
any other input fields. The AS/400 application user must be aware of this, 
since the 5494 may not detect overlapping errors, depending on the 
workstation controller. 


Scroll Bar Indicators Minor Structure: The optional scroll bar indicators minor 
structure enables the AS/400 application to specify the character values and 
highlighting to be used when presenting a scroll bar. The 5494 uses default 
characters in the scroll bar if alternative characters are not specified by this optional 
minor structure. When this minor structure is issued, the alternate characters are 
applied to the scroll bar field only. When the scroll bar field is updated, it is 
necessary to resend the scroll bar indicators minor structure. The format of the 
scroll bar indicators minor structure is the same as a scroll bar on a selection field. 
See “Scroll Bar Indicators Minor Structure” on page 15-65. 


How the 5494 Processes the Define Scroll Bar Field: The 5494 processes the 
define scroll bar field as: 


Scroll Bar Field Definition Limitations: Scroll bar field data is stored in the 
FFT storage area. Three FFT entries are made for a scroll bar field. A 
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maximum of 256 FFT entries are allowed. If you specify more than 256 FFT 
entries, a negative response is returned. 


Scroll Bar Field Redefinition: The AS/400 application can redefine a scroll bar 
field by sending another scroll bar field major structure to the same screen 
buffer address that was used when the field was initially defined. Rows, 
columns, and vertical and horizontal orientation must remain the same when a 
‘scroll bar field is redefined. A negative response is returned if you attempt to 
change these parameters. 


Inbound Scroll Bar Field Data: Each scroll bar field returns 4 bytes of inbound 
data (a scroll increment). These bytes will be zero unless the requested key is a 
roll up, roll down, roll left, or roll right request. However, one of the following 
conditions must have occurred: 


e A PWS or NWS user has used the scroll bar arrows. In this case, the scrolling 
increment is set to the value of X'00000001 ' to indicate a single row or column 
scroll request. | 


e A PWS or NWS user has dragged and dropped the scroll bar slider using a 
pointer device. The scroll increment specifies the number of rows or columns 
that are to be scrolled. The increment could be larger than the number of rows 
that the AS/400 had specified for the (up or down) direction when the selection 
field was defined. 


READ MODIFIED FIELDS Command Processing: For all READ MODIFIED type 
commands, inbound data is returned only if the scroll bar field MDT is set to on. 
The SBA address that is returned before the field data is the scroll bar field 
address. 


REMOVE GUI SCROLL BAR FIELD Structured Field 

It is recommended that you use this structured field with caution. The REMOVE 
GUI SCROLL BAR FIELD command can be used to delete a GUI scroll bar 
construct. For a PWS, a scroll bar created by a define scroll bar field major 
structure can be a GUI construct. Because NWS scroll bars are made up of 
characters, the 5494 ignores this command. 


The current display address must be the same as when the scroll bar was created 
by a define scroll bar field major structure. A PWS attempts to find a match 
between the current display address and a GUI scroll bar. When a match is found, 
the GUI construct is deleted but the display screen is not cleared. 


It is important to have a CLEAR FORMAT command or SOH order follow the 
REMOVE GUI SCROLL BAR FIELD structured field in the same display data 
stream. 


REMOVE GUI SCROLL BAR FIELD Major Structure: The remove GUI scroll bar 
field major structure must follow the WDSF order (See “WRITE DATA Structured 
Field” on page 15-93). 


Table 15-26 on page 15-93 describes the format for the remove GUI scroll bar 
field major structure. 


Functions Reference 


Table 15-26. Format of Remove GUI Scroll Bar Field Major Structure 


Byte Name Value Description 

1-2 Major 6 | Length of structured field in bytes (including 
Length length bytes). 

3 Class X'D9g! Class of structured field. 

4 Type X'5B' Type of structured field. 

5 Flag Byte Bits 0-7 Reserved (must be set to off). 

6 Reserved X'00' Reserved (must be set to zero). 


WRITE DATA Structured Field 

The WRITE DATA structured field can be used to write data to any type of entry 
field, or to initialize an entry field. Writing data to an entry field or initializing an 
entry field is complicated by the introduction of continued fields, especially 
ideographic continued entry fields, and word wrap fields. The WRITE DATA 
structured field offloads the task of splitting data between segments of continued 
entry fields, and between lines of a multiple row entry field to the 5494 if word wrap 
is specified. 


Typically the current display address should be set using an SBA order to the first 
position of the desired entry field. If the entry field is a continued entry field, the 
current display address must be set to the first position of the first segment. Fora 
right-to-left entry field, the current display address must be set to the leftmost 
position—the same as a left-to-right field. However, the data is written starting from 
the rightmost position of the right-to-left entry field. 


Note: Write Data processing into a right-to-left entry field is consistent with 
inbound data from a right-to-left Word Wrap entry field; the AS/400 system does not 
need to reverse the entry field data. 


The current display address is not modified as a result of this command. 


WRITE DATA Major Structure: The structured field must follow a Write to Display 
Structured Field order (see “WRITE DATA Structured Field’). 


Table 15-27. Format of Write Data Major Structure 


Byte Name Value Description | | 
1-2 Major >6 Length of structured field in bytes (including 
Length length bytes). 
Class X'D9' Class of structured field. 
Type X'54' Type of structured field. 
Flag byte Bit O Write data to entry field, if set to on. 


Bits 1-7 Reserved (should be set to off—ignored by the 


5494). 

6 Reserved X'00' Reserved (should be zero—ignored by the 
5494). 

7-n Field Data The data which is to be written to the entry field. 


WAITE DATA Major Structure Parameters: The Write Data Major structure 
parameters are defined as follows: 
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Write Data to Entry Field 


Indicates the data in the Field Data parameter can be 
written to the entry field at the current display address. 
If this flag is set to off, a negative response is returned. 


Field Data Specifies the data to write to a field at the current display 


address. A negative response is returned if the major 
length is valid, but the field data is too long for the entry 
field. Field data should not include display attributes 
(X'20'—X'3F') or X'FF'. 


Writing Data to Entry Fields: \f the current display address is not the first 
position of an entry field, a negative response is returned. Otherwise, the following 
algorithm is used to write the field data: 


Functions Reference 


If the host elects to null a non-double-byte entry field (or null an ideographic 
either field into single byte mode), the field data type can be 1 null. If the entry 
field is a continued field, all entry field segments are nulled. 


Each consecutive character is put into the next consecutive character position 
starting at the first entry field position, and going left-to-right and downward 
through the entire field or set of continued field segments, until all the 
characters have been placed into the field. For right-to-left fields, the data is 
written starting at the right side of each field or field segment. Any remaining 
field positions are nulled. 


If the field is an ideographic only entry field, the first data character must be an 
SO. At least 1 double-byte character must be included, and the last data 
character must be an SI. Otherwise the 5494 will return a negative response. 
No other SO or SI characters should be included in the data. The 5494 writes 
the SI at the last field position and fills in with double-byte nulls from the last 
double-byte character to the SI to completely fill the field. If the entry field is a 
continued entry field, the 5494 adds SI characters to the end of first and middle 
continued field segments, and adds SO characters to the start of middle and 
last field segments. If the field is to be nulled, the data must consist of a SO, 
double-byte null (X'0000'), and an SI. 


If the field is a ideographic either entry, the field is set to single- or double-byte 
mode; double-byte mode if the first character is an SO. If double-byte data is 
being written, the first character must be an SO, at least one double-byte 
character must be included, and the last character must be an SI. No other SO 
or SI characters should be included in the data. If the field is set to 
double-byte mode and nulled, the data should consist of an SO, double-byte 
null (X'0000'), and an Si. If the first character is not an SO, the ideographic 
either field is set to single-byte mode. 


If the field is an ideographic open continued field, ideographic data that does 
not completely fit on a segment is automatically split between segments. This 
can require extra SI, SO character pairs to be inserted—at the end of the 
current segment and start of the next segment, respectively. Nulls can also be 
required following the SI on the current segment to pad to the end of the 
segment. A double-byte character does not fit in a segment when there are 


only 2- or 1-character positions remaining on a segment. When a double-byte 


character does not fit on a segment, the double-byte data on the current 
segment is terminated with an SI character. Or if the preceding character is 
the SO character, it is removed. The current segment is then padded to the 


end with nulls. An SO is placed at the beginning of the next segment. If the 
field is to be nulled, the field data should be 1 null (X'00'). 


e If the field is an ideographic data type, the first 3 bytes of the data must be an 
extended SO attribute (X'120581' which is a WEA extended SO), at least 1 
double-byte character must be included, and the last 3 bytes of data must be 
an extended Sl attribute (X'120580' which is a WEA extended Sl). Otherwise, 
the 5494 returns a negative response. If the field is to be nulled, the field data 
must be an extended SO attribute, a double-byte null (X'0000'), and an 
extended SI attribute. 


e lf the field has word wrap specified and an entire word does not fit on the 
current segment of a continued field, or the current line of a field that spans 
lines, the segment or line is padded with nulls, and the whole word is moved to 
the next segment or line. See page 15-28 for details on word wrap entry fields. 
If all of the data does not fit within a word wrap field, the data is rewritten to the 
field as without word wrap set to on. 


PROGRAMMABLE MOUSE BUTTONS Structured Field 

The Programmable Mouse Buttons structured field can be used to associate AIDs 
with various pointer device (mouse) events. Single-event AlDs and two-event AIDs 
can be programmed. 


Single-event AlDs can be used for such action as to reorder the layering of 
windows, or to select objects. For example, the middle button down can be 
programmed as a single-event AID when multiple windows are on the screen, to 
enable window reordering. Then when the user presses the middle button, the 
cursor is moved to the pointer device cursor location and the host-defined AID is 
returned. The application uses the host-defined AID to recognize a reorder 
request, and uses the inbound row/column cursor address to determine if the 
pointer device event occurred within an overlayed window. lf yes, the windows can 
be reordered by the application. 


Two-event AlDs can be used for actions such as to enable windows to be moved 
and sized. For example, the right button down/right button up can be programmed 
as a two-event AID to enable a window to be moved. Then, when the user presses 
the right button, a marker box is drawn at the pointer device cursor location on a 
capable NWS and the color of the pointer device cursor is changed to white on a 
capable color NWS. Then, the user can move the pointer device cursor and when 
the user releases the right button, the marker box is removed, the pointer device 
cursor color is set to the input inhibited color, the cursor is moved to the location of 
the pointer device cursor, and two AIDs and two row and column addresses are 
returned to the application. The application uses the two-event AID (X'80') and 
the second host-defined AID to recognize a window move request. If the second 
inbound row and column cursor address is on the window title (where the user 
pressed the right button), then the application uses the first row and column 
address (which is the text cursor location where the right button was released) to 
determine the number of rows and columns that the window must move. 


Note: Using programmable mouse buttons can prohibit other lower-priority pointer 
device functions on the display screen. 


PROGRAMMABLE MOUSE BUTTONS Major Structure: The structured field 
must follow a Write to Display Structured Field order as described in “WRITE TO 
DISPLAY Structured Field Order” on page 15-34. 
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Table 15-28. Format of Programmable Mouse Buttons Major Structure 


Byte 
1-2 


oO |] oo] & 1] Ww 


Table 15-29. 
| Byte 
1 


Functions Reference 


Description 


Length of structured field in bytes (including 
length bytes). A length = 7 causes the 
programmable mouse button table to be reset. 
The length must be a multiple of 4, plus 7 (for 
example, 7, 11, 15, and so on). Because 
programmable mouse button event definitions 
are 4 bytes each, a negative response is 
returned if the length is not valid. 


Class of structured field. 
Type of structured field. 
Reserved (must be zero—ignored by the 5494). 


Reserved (should be zero—ignored by the 
5494). | 


Reserved (should be zero—ignored by the 
5494). 


Optional Programmable Mouse Button Event 
Definitions. See Table 15-29 on page 15-96. 
The programmable mouse button table is reset if 
no event definitions are included. One or more 
definitions can be included. 


Format of Each Programmable Mouse Button Event Definition 


Name Value 

Major >6 

Length 

Class X'D9Y' 

Type X'55' 

Reserved X'00' 

Reserved X'00' 

Reserved X'00' 

Programmable 

Mouse 

Button 

Event 

Definitions 

Name Value 

Flag byte Bit O 
Bit 1 
Bit 2 
Bit 3 
Bits 4—7 

First Mouse 

Event 

(leading 

edge event) 

Second 

Mouse 

Event 

(trailing 

edge event) 

AID to be 

returned 


Description 


Single-event definition is set to off and two-event 
definition if set to on. 


The text cursor is moved to the location of the 
mouse cursor when set to on. 


The single mouse event is queued if the 
keyboard is locked when set to on. 


A marker box is drawn on the first event of a — 
two-event definition when set to on. 


Reserved (should be set to off—ignored by the 
5494). 


The mouse event for a single-event, or the 
leading edge of a two-event sequence. 


This parameter is used if this is a two-event 
sequence. The mouse event for the trailing 
edge of a two-event sequence. This parameter 
is ignored if this is a single-event sequence. 


The host-defined AID to be returned to the host, 
when a user completes the single- or two-event 
sequence. 


PROGRAMMABLE MOUSE BUTTONS Event Definitions: These definitions 
specify mouse events. If none are present, the programmable mouse button table 
is reset. If multiple event definitions exist for the same event, only the last 
definition is used. You may not identify the same event as both a single event and 
the first event of a two-event sequence. A first event may have only one second 
event. You may not define the same first event a second time with a different 
second event. However, the same second event may be defined for multiple 
different first events. 


PROGRAMMABLE MOUSE BUTTONS Parameters: The programmable mouse 
buttons parameters are defined as follows: 


Single-Event Definition This flag specifies whether this definition is for a single 
event or a two-event sequence. The flag is set to on for a two-event 
sequence. 


Text Cursor is Moved This flag should normally be set to on to indicate that the 
text cursor should be moved to the location of the mouse cursor when 
the host-defined AID is sent. However, if this flag is set to off, the text 
cursor is not moved. 


Single Event is Queued In some cases, an application elects to program two 
different event definitions for the same button. For example, program a 
right button down single-event definition and a right button double click 
single-event definition. Using this example, the keyboard is probably 
locked when a right button double click occurs because the previous 
right button event AID was sent to the host. If this flag is set to on fora 
single-event definition and the keyboard is locked when the mouse 
event occurs, the AID is queued in the 5494 until the keyboard is 
unlocked. Using the above example, the application detects the first 
right button AID, but can ignore this event (based on text cursor 
position) by unlocking the keyboard again. Or the application can 
update the display screen and unlock the keyboard. Then, the 
application detects the right button double click AID and performs some 
other action. This flag is ignored for two event definitions. 


Draw a Marker Box This flag is normally set to on for two-event definitions. If this 
flag is set to on, the user sees the location where the first event 
occurred. However, if this flag is set to off, no marker box is drawn. 
This flag is ignored for single-event definitions. 


Mouse Events The following event values are used in the first and second mouse 
event parameters. There are 18 mouse events possible: 3 buttons with 
3 events; each event (up, down, and double click) two keyboard states 
(shifted and unshifted). Each mouse event has a corresponding 1-byte 
value. Reserved values cause the programmable mouse button event 
definition to be ignored. The mouse event values are: 


e X'00'—Reserved 

e X'01'-Left button pressed 

¢ X'02'-Left button released 

e X'03'-—Left button double click 
e X'04'—Right button pressed 

¢ X'05'—Right button released 

¢ X'06'—Right button double click 
e X'07'-—Middle button pressed 

¢ X'08'-—Middle button released 
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e X'09'—Middle button double click 

¢ X'0A'-Shifted left button pressed 

e X'0OB'-Shifted left button released 

¢ X'0OC'-Shifted left button double click 
e X'OD'-Shifted right button pressed 

e X'OE'-Shifted right button released 

e X'OF'-Shifted right button double click 
¢ X'10'—Shifted middle button pressed 

e X'11'-—Shifted middle button released 
e X'12'-—Shifted middle button double click 
e X'13' through X'FF'—Reserved 


AID to be Returned The AID associated with a mouse event can be any currently 
defined AID, or a host-defined AID value between X'70' and X'7F'. 
Invalid AID values cause the mouse event/AID pair to be ignored. 


Also, a new AID is defined: the Programmable Mouse Button Two-Event 
AID, X'80'. This AID is not specified by the host, but this AID is 
returned in the inbound data for a two event sequence. See 

Table 15-31 on page 15-99. 


PROGRAMMABLE MOUSE BUTTONS Operations: The table of AIDs 
associated with mouse events is always cleared when any new Programmable 
Mouse Button structured field is received. This table is also cleared when any of 
the following commands are received: 


e CLEAR UNIT or CLEAR UNIT ALTERNATE 
e RESTORE or RESTORE PARTIAL SCREEN (recreates a previous display 
screen, including the programmable mouse buttons AID table). 


When a mouse event occurs that has been programmed as a single event by using 
this structured field and no other function has higher priority (such as selecting a 
selection field choice for an unshifted left button press event), the keyboard is 
locked, the cursor is optionally moved to the pointer device cursor location, and the 
specified AID is returned to the host. If the specified AID normally returns inbound 
entry field data, inbound data entry field is included. The format of the inbound 
data is like typicai inbound data: 


Table 15-30. Format of Single Event Inbound Data 


Byte Name Value Description 
1 Row 1-27 The row address of the text cursor 
Column 1-132 The column address of the text cursor 
3 AID The host-defined AID for this single event 
definition 
4—n Field Data Optional field data (depending on the 


hosi-defined AID and the field MDTs) 


When a programmable two-event definition is specified, inbound data is not 
returned until the trailing edge event also occurs. When the leading edge event is 
received, a programmable-two-event state is entered, the mouse cursor location is 
saved, a marker box is optionally drawn around the location of the mouse cursor on 
a capable NWS, the mouse color is changed to white on a capable color NWS, and 
the trailing edge event is located. Such actions as keystrokes or host data streams 
cancel the programmable-two-event state. Some mouse events are ignored while 


Functions Reference 


waiting for the trailing edge. When the trailing edge event is received, the marker 
box is erased, the mouse cursor color is changed to input inhibited, the keyboard is 
locked, the text cursor is optionally moved to the location of the mouse cursor, and 
inbound data returned to the host. If the specified host-defined AID normally 
returns inbound entry field data, inbound data entry field is included (note that this 
AID is stored in byte 6 for two-event inbound data). 


The format of the two-event inbound data is as follows: 


Table 15-31. Format of Two-Event Inbound Data 


Byte Name Value Description 

1 Row 1-27 The row address of the text cursor. 

2 Column 1-132 The column address of the text cursor. 

3 AID X'80' The programmable mouse button two-event AID 


is returned—this is the only time this AID is 
returned to the host 


4 Row 1-27 The row address of where the first event 
occurred (leading edge). 


5 Column 1-132 The column address of where the first event 
occurred (leading edge). 

6 AID The host-defined AID for this two-event 
definition. 

7—-n Field Data Optional field data (depending on the 


host-defined AID and the field MDTs). 


Draw/Erase Grid Lines Structured Field 


Use the Draw/Erase Grid Lines structured field to draw or erase one or more grid 
lines or a box on the display screen. Use this command only with displays that are 
capable of drawing grid lines. 


The Draw/Erase Grid Lines structured field must follow the WRITE TO DISPLAY 
STRUCTURED FIELD order. 


Table 15-32 (Page 1 of 2). Format for Draw/Erase Grid Lines Structured Field Major 


Structure 

Byte Name Value Description 

1-2 Major 9-n Length of structured field in bytes (including 
Length | length bytes 
Class X'DY' 5250 Class of structured field 

4 Type X'60' Draw/Erase Grid Lines structured field type 
Partition X'01' Specifies which grid line buffer in the display this 


Grid Line Structured field addresses. Currently 
there is only one grid line buffer in the display. 
A partition value of X'01' addresses the primary 
buffer. 
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Table 15-32 (Page 2 of 2). Format for Draw/Erase Grid Lines Structured Field Major 


Structure 
Byte 
6-7 


10 


12-n 


Functions Reference 


Name Value 


Pre-process 
Flags 


Bit O 


Bits 1-15 


Post-process 
Flags 


Bit 0 


Bits 1-15 


Default 
Color for 
Grid Lines 


Default 
Line Style 


Minor 
Structures 


Description 


Items within these flags are processed before 
any minor structures are processed 


Clear the grid line buffer specified by the 
partition byte if set to on. 


Reserved (must be set to off) 


Items within these flags are processed after all 
minor structures have been processed. 


Clear the grid line buffer specified by the 
partition byte if set to on. 


Note: This would clear any grid lines specified 
by the minor structures. 


Reserved (must be set to off) 


Sets the color for all minor structure grid lines 
unless an individual minor structure specifies a 
color to use. Valid colors are: 


X'01' Blue X'09' Light Blue 
X'02' Green X'OA' Light Green 
X'03' Cyan X'OB' Light Cyan 
X'04' Red X'0C' Light Red 
X'05' Violet X'OD' Light Violet 
X'06' Yellow X'OE' Light Yellow 
X'07' White X'OF' Intense White 
X'08' Grey X'10' Black | 


X'FF' Use default color for the display. (This 
color may vary from display to display.) 


Note: Any other value than the ones listed 
above will result in the default color being 
selected. 


Sets the type of line that will be used for all 
minor structures unless the individual minor 


- structure specifies a type to use. The available 


types are: 


X'00' Solid line | 

X'01' Thick solid line (bold) 

X'02' Double line 

X'03' Dotted line 

X'08' Dashed line 

X'09' Thick dashed line (bold) 

X'0A' Double dashed line 

X'FF' Use default line for the display. 
(This line choice may vary from display to 


display.) 


One or more minor structures 


Draw/Erase Grid Lines Minor Structure 

This optional structure is used to draw or erase one or more grid lines. Grid lines 
may be upper or lower horizontal, and left or right vertical. They are defined with a 
starting position and length and may be drawn in the same colors and styles as 
those listed in the major structure. They may also be repeated at a specified line 


interval. 


This structure may also be used to draw or erase a box. The box may be ruled 
horizontally, vertically, or both. 


Table 15-33 (Page 1 of 2). Format for Draw/Erase Grid Lines Structured Field Minor 


Structure 
Byte 
1 


Name 


Minor 
Length 


Construct 


Flag 


Start 
row 


Start 
Column 


Horizontal 
Dimension 


Vertical 
Dimension 


Color 


Value 
7-11 


0-6 


Bit O 


Bits 1-7 


1-maximum 


row 


1-maximum 


columns 


1-(maximum 


columns - 
Start 
column 
+1) 


1-(maximum 


rOWS - 
start 
row + 1) 


Description 


Length of minor structure in bytes (including 
length bytes) 


Type of construct to be drawn: 


X'00' Upper horizontal line 

X'01' Lower horizontal line 

X'02' Left vertical line 

X'03' Right vertical line 

X'04' Plain box 

X'05' Horizontally ruled box 

X'06' Vertically ruled box 

X'07' Horizontally and vertically ruled box 


Control flags © 


Draw/Erase the construct specified 
0 = Draw 
1 = Erase 


Reserved (must be set to off) 


Specifies the row of the upper left position of the 
construct. 


Specifies the column of the upper left position of 
the construct. 


Specifies the length of the horizontal line or the 
width of the box being defined. 


If this value causes the line or box to be defined 
outside the screen, a negative response is 
generated. 


Specifies the length of the vertical line 
or the height of the box being defined. 


If this value causes the line or box to be defined 
outside the screen, a negative response is 
generated. 


Specifies the color of this line or box. This color 
value may be any of the colors defined in the 
major structure and it overrides the color 
selected in the major structure. 


X'FF' Use the color specified in the Major 
structure. 
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Table 15-33 (Page 2 of 2). Format for Draw/Erase Grid Lines Structured Field Minor 
Structure 


Byte Name Value Description 
9 Line | Specifies the line style of this line or box. This 
Style value may be any of the line style values defined 

in the major structure and it overrides the line 
style selected in the major structure. 
X'FF' Use the line style specified in the Major 
structure. | 

10 Line repeat >=1 For lines: Specifies the number of times the line 


or box 


is to be repeated. 


horizontal For boxes: Specifies the interval (in rows) 
rule between horizontal rule lines for ruled boxes. 
interval 
If not specified, the default is 1. 
A negative response will be generated if: 
e This value ts zero 
e This value combined with the line interval 
exceeds the screen size for lines. 
e This value exceeds the height for boxes 
11 Line >=1 For lines: Specifies the interval between 
interval repeated lines (in rows or columns). 
or box For boxes: Specifies the interval (in columns) 
vertical between vertical rule lines for ruled boxes. 
rule 
interval If not specified, the default is 1. 


A negative response will be generated if: 


e This value is zero 

e This value combined with the line repeat 
exceeds the screen size for lines. 

e This value exceeds the width for boxes. 


CLEAR GRID LINES Structured Field 


Use the Clear Grid lines structured field to clear all grid lines within a rectangular 
area of the screen. 


If the entire grid line buffer is cleared by this major structure (i.e. start row and 
column = 1 and rectangle width and height = screen width and height) the grid line 
buffer will be assumed to be not in use. Clear the entire grid line buffer when it is 
no longer in use. 


The Clear Grid Lines structured field must follow the WRITE TO DISPLAY 
STRUCTURED FIELD order. 


Table 15-34 (Page 1 of 2). Format for Clear Grid Lines Structured Field Major Structure 


Byte Name Value Description 
1-2 Major — 9 Length of structured field in bytes (including 
Length length bytes) 
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Table 15-34 (Page 2 of 2). Format for Clear Grid Lines Structured Field Major Structure 


Byte Name Value Description 

3 Class X'DY' 5250 Class of structured field 

4 Type X'61' Clear Grid Lines structured field type 

5 Partition X'01' Specifies which grid line buffer in the display this 


Grid Line Structured field addresses. Currently 
there is only one grid line buffer in the display. 
A partition value of X'01' addresses the primary 


buffer. 
6 Start row 1-maximum Specifies the row of the upper left position of the 
| row rectangle to be cleared. 
7 Start 1-maximum Specifies the column of the upper left position of 
Column columns the rectangle to be cleared. 
8 Width of 1-(maximum Specifies the horizontal width (in columns) of the 
Rectangle columns - rectangle. 
start 
column 
+ 1) 
8 Height of 1-(maximum Specifies the vertical height (in rows) of the 
Rectangle rows - rectangle. 
start A negative response will be generated if this 
row + 1) value combined with the width of the rectangle 


exceeds the screen boundary. 


WRITE ERROR CODE Command 


The AS/400 system issues the WRITE ERROR CODE command to force the 
keyboard into the pre-help error state. The pre-help error state is the same state 
that occurs when the workstation operator makes a keying error. The command 
code is X'21'. 


ESC WRITE ERROR CODE IC@@ Data 
X'04' X21! 


IC @@ Optional insert cursor order 


Data Optional data. A maximum of 80 or 132 characters, depending on screen 
size, is allowed. The first byte should be an attribute of high-intensity 
blink and the last byte should be an attribute of nondisplay. 


Note: A parameter error negative response results if either an IC order or data 
does not follow the WRITE ERROR CODE command byte. 
When the AS/400 system issues this command, processing proceeds as follows: 


1. The keyboard enters pre-help error state. In this state, the keyboard clicker is 
off, the Insert, Diacritic, and Command modes are cleared, and the cursor is 
blinking. The AS/400 system clears the lock state if the workstation is locked 
and is not in post-help error state. 


2. If an IC order appears in the command, the cursor moves immediately to the 
specified location. This operation does not affect the system IC address that 
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the WTD command sets. However, all past knowledge of processing at the 
former cursor location disappears. 


3. The 5494 saves data on the error line, including any extended attributes, if the 
data is not already being used for error presentation. The line is cleared to 
prepare for writing the error data. If the display is capable of extended 
attributes, a normal display extended attribute is written to column 1 of the 
extended attribute plane. Any data found between the command byte and the 
end of the SNA chain or next escape character, other than the 3-byte IC order, 
appears on the error line. 


4. The 5494 clears any outstanding AID request. 


This command alters the normal processing sequence as follows: 


e When the command includes an IC order, the cursor responds without regard 
for the exit criteria normally imposed on fields having self-check capabilities. 


e When the workstation operator presses the Help key in the pre-help error state, 
the 5494 inserts an attribute of high intensity non-blink in column 1 of the error 
line, regardless of its previous definition. 


e When the workstation operator presses the Help key, the 5494 transmits the 
dezoned, packed bytes from columns 2 through 5 of the error line. 


WRITE ERROR CODE TO WINDOW Command 


The AS/400 system issues the WRITE ERROR CODE TO WINDOW command to 
force the keyboard into the pre-help error state, the same state that occurs when 
the workstation operator makes a keying error. This command is similar to the 
WRITE ERROR CODE command except that 2 parameter bytes follow the 
command that describe the start and end columns. The command code is X'22'. 


WRITE ERROR CODE TO START END 


WINDOW COLUMN COLUMN 
X'22' 1 through 131 2 through 132 





The WRITE ERROR CODE TO WINDOW command can be used inside of a 
window. The screen characters to the left and right of the window remain 
unchanged. 


The end column must be greater than the start column. The remaining data has 
the same format as the WRITE ERROR CODE command data. If the data you 
send is too large to fit between the specified start and end columns, the data Is 
truncated. 


When the 5494 receives a WRITE ERROR CODE TO WINDOW command, it sets 
the error line to null from the start column to the end column and then writes the 
message text starting at the specified start column. If the display is capable of 
extended attributes, a normal display extended attribute is written to the start 
column of the extended attribute plane. 


If a separate display error line is being used (row 25 for a 24 x 80 screen or row 28 
for a 27 x 132 screen), the 5494 will return a negative response. 
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READ INPUT FIELDS Command 


The AS/400 system issues the READ INPUT FIELDS command to the 5494 to 
initiate input of the data residing in every field defined by the format table. The 
command code is X'42'. 


ESC READ INPUT Control Character 
X'04' X'42! 2 Bytes 


The format of the control character following the READ INPUT command is 
identical to that in the WTD command. The 5494 completes the actions indicated 
by this character after servicing the READ INPUT command. 


When the 5494 receives a READ INPUT command, the command remains pending 
until the workstation operator presses an AID key. Once this requirement has been 
satisfied, the 5494 services the command and clears the AID request immediately 
or upon receipt of the next CD bit. 


The format of data returned to the AS/400 system in response to a READ INPUT 
FIELDS command is: 











Cursor Address In 
Row/Column Format 
2 bytes 





AID Code Field Data Field Data Field Data 
1 byte 


The code immediately after the cursor address indicates the particular AID key 
pressed by the workstation operator. These codes are defined in Table 16-1 on 
page 16-5. 





Field data is returned only when at least one field has its MDT set to ON and the 
AID is one of the following keys: 


Enter or Record Advance 

Roll Up/Down/Left/Right 

PF 1—24 (unless masked in SOH order) 
SLP Auto-enter 

Forward Edge Trigger Auto-enter 


If field data is not returned, only the cursor address and AID code are returned. 


When the 5494 returns the field data to the AS/400 system, it converts all null fields 
to blanks. If a field is a signed numeric field, the 5494 checks the last location of 
the field for a negative sign. If the 5494 detects a negative sign, it changes the 
zone portion of the second-to-last character of the field to X'D' and strips off the 
last character of the field. 


The workstation sends the complete contents of each field defined in the format 
table to the AS/400 system in the order that the fields appear in the table. The 
AS/400 system can alter this order with FCWs that request resequencing. 


The starting and ending addresses of each field reside in the format table. Any 


attributes within a field (between field starting and ending attributes) are transferred 
to the AS/400 system along with the actual character codes. 
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The 5494 does not edit transparent data returned to the AS/400 system, nor does it 
send any intervening control information. If a field is both transparent and signed 
numeric, it could affect the accuracy of field data. 


A resequencing error occurring while a READ INPUT FIELDS command is active 
causes the 5494 to issue a corresponding LUSTAT command on the normal LU-LU 
flow. 


READ MDT FIELDS Command 


The AS/400 system issues the READ MDT FIELDS command to read only those 
format table fields that have the MDT bit on. The MDT bit can be set by the input 
from a workstation or by the AS/400 system. The command code is X'52'. 


ESC READ MDT FIELDS Control Character 
X'04!' x'52!' : 2 bytes 


The format of the control character following the READ MDT FIELDS command is 
identical to that in the WTD command. The 5494 completes the actions indicated 
by this character after servicing the READ MDT FIELDS command. 


When the 5494 receives a READ MDT FIELDS command, the command remains 
pending until the workstation operator presses an AID key. Once this requirement 
has been satisfied, the 5494 services the command and clears the AID request 
immediately or upon receipt of the next CD bit. 


The format of data returned in response to a READ MDT FIELDS command is: 





AID SBA Field SBA - 
Code X'11' Data X'11' 
1 byte 


Field data is returned only when at least one field has its MDT set to ON and the 
AID is one of the following keys: 


Enter or Record Advance 
Roll Up/Down 
PF 1—24 (unless masked in SOH order) 


If field data is not returned, only the cursor address and AID code are returned. 


The cursor address and AID code fields contain the same information as an input 
data stream fora READ INPUT FIELDS command. However, because this data 
stream only includes those fields having the MDT bit on, the 5494 inserts an SBA 
code and the field address before the field data. The SBA codes serve as a 
delimiter between successive fields, and the field addresses enable the AS/400 
system to determine which fields are included in the transmission. The 5494 
processes this command as follows: 


e The command remains pending until the workstation operator presses the 
Enter, Roll Up, Roll Down, or Command/PF key (SOH bytes 5 through 7 off). 


e For non-transparent fields, the transmission only includes the SBA code and 
the address. Null data is suppressed. 
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e Signed numeric fields are configured the same as for a READ INPUT FIELDS 
command. 


e Field resequencing remains the same as for a READ INPUT FIELDS 
command. 


Note: When a transparent field is included in the data stream produced in 
response to a READ MDT FIELDS command, the data consists of an SBA with row 
and column followed by: 


e A TD code (X'10') | 
e A 2-byte length field containing the length of the transparent data, not counting 


the 2 length bytes 
e The transparent data 


An attempt to transmit a field that is both signed numeric and transparent will 
produce unpredictable results. 


Note: For ideographic data type fields, the SBA value returned with the data may 
be customized to X'04' or X'11', using the 5250 WORKSTATION 
CUSTOMIZATION command. An SBA value of X'04' is used only between the 
5494 and the AS/400 operating system. AS/400 applications do not receive the 
X'04' value. 


READ MDT ALTERNATE Command 


The READ MDT ALTERNATE command is functionally similar to the READ MDT 
FIELDS command with the following exceptions: 


e Leading and embedded nulls within the fields remain nulls. However, trailing 
nulls are stripped off. 


e For fields consisting entirely of nulls, but with the MDT bit on, the 5494 returns 
only an SBA order followed by the fields address. 


The command code is X'82'. See “READ MDT FIELDS Command” on 
page 15-106 for more information. 


ESC READ MDT ALTERNATE Control Character 
X'04! X'82' — 2 bytes 


READ SCREEN Command 


The AS/400 system issues the READ SCREEN command to obtain data currently 
on the screen. When the 5494 executes this command, it transmits screen data to 
the AS/400 system from the regeneration buffer without any data conversion or 
formatting. The command code is X'62'. 


ESC READ SCREEN 
X'04' X'62' 


The 5494 does not clear pending AID requests or queued read commands when it 
processes the READ SCREEN command. It does lock the keyboard until data 
transmission is complete. 
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The 5494 rejects the READ SCREEN command if: 


e It is not the last command in the SNA chain. 

e The 5494 does not have a CD bit. 

e The workstation which does not have a separately displayable message line, or 
a workstation which has a separately displayable but not selected message 
line, is in pre-help error, post-help error, system request, or SS message state. 

e The workstation which has a separately displayable and currently selected 
message line is in system request or SS message state. 


READ SCREEN WITH EXTENDED ATTRIBUTES Command 


The AS/400 system issues the READ SCREEN WITH EXTENDED ATTRIBUTES 
command to obtain screen data and any non-null extended attributes. A null 
attribute is X'00'. The command code is X'64'. 


ESC READ SCREEN WITH EXTENDED ATTRIBUTES 
— X!04! X'64' 


When the 5494 executes this command, it transmits all data on the display screen 
with the non-null extended attributes intermixed with the screen data. Trailing nulls 
on each line are truncated. The end of the line is indicated by the X'FF' 
end-of-row character. For a non-null extended attribute, the 5494 inserts 3 bytes 
within the returned data: 


Preceding Attribute Extended Extended Screen Following 


Screen ESC Attribute Attribute Character Screen 
Data X'10' Plane Data 





Attribute Escape (X'10') indicates a non-null extended attribute in the returned 
data. The valid extended attribute planes are: 


X'01' — Extended primary attributes 

X'02' — Extended text attributes | 
X'03' — Extended foreground color attributes 
X'05' — Extended ideographic attributes. 


The valid primary, foreground color, and ideographic attributes are described under 
“Write Extended Attribute Order” on page 15-14. 


Valid extended text attributes are X'80'—X'87' as defined in Table 15-35. 


Table 15-35 (Page 1 of 2). Extended Text Attributes 


Bits Description 
0 Attribute flag 
1 = Attribute change 
1-4 Reserved 
5 Word Underscore 


1 = Word Underscore 


6 Half Index Down 
1 = Half Index Down 
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Table 15-35 (Page 2 of 2). Extended Text Attributes 
Bits Description 


7 Half Index Up 
1 = Half Index Up 


Note: Extended text attributes are only used in WP mode. 


The 5494 does not clear pending AID requests or queued read commands when it 
processes the READ SCREEN WITH EXTENDED ATTRIBUTES command. The 
keyboard state is not affected. 


The 5494 rejects the READ SCREEN WITH EXTENDED ATTRIBUTES command 
under the same conditions as it rejects the READ SCREEN command. See “READ 
SCREEN Command” on page 15-107. The 5494 also rejects the command if the 
display does not have extended attribute capability. 


READ SCREEN TO PRINT Command 


The AS/400 system issues the READ SCREEN TO PRINT command to obtain data 
currently on the screen. When the 5494 executes this command, it transmits 
screen data to the AS/400 system from the regeneration buffer with some data 
conversion. The command code is X'66'. 


ESC READ SCREEN TO PRINT 
X'04!' X'66' 


The READ SCREEN TO PRINT command is similar to the READ SCREEN 
command except that the 5494 maps GUI-like characters in the inbound data to 
their non-GUI-like character defaults (periods, colons). If your NWS has no 
GUl-like characters, the inbound data format is exactly the same as the READ 
SCREEN command format. 


READ SCREEN TO PRINT WITH EXTENDED ATTRIBUTES Command 


The AS/400 system issues the READ SCREEN TO PRINT WITH EXTENDED 
ATTRIBUTES command to obtain screen data and any non-null extended 
attributes. A null attribute is X'00'. The command code is X'68'. 


READ SCREEN TO PRINT WITH EXTENDED 


ATTRIBUTES 
X'68' 





The READ SCREEN TO PRINT WITH EXTENDED ATTRIBUTES command is 
similar to the READ SCREEN WITH EXTENDED ATTRIBUTES command except 
that the 5494 maps GUlI-like characters in the inbound data to their non-GUI-like 
character defaults (periods, colons). If your NWS has no GUI-like characters, the 
inbound data format is exactly the same as the READ SCREEN WITH EXTENDED 
ATTRIBUTES command format. 


Note: The 5494 sends a negative response to the AS/400 system if your NWS 
does not have extended attribute support. 
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READ SCREEN TO PRINT WITH GRID LINES Command 
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The AS/400 system issues the READ SCREEN TO PRINT WITH GRID LINES 
command to obtain data and grid lines currently on the screen. Like the READ 
SCREEN TO PRINT COMMAND, the 5494 transmits screen data to the AS/400 
system from the regeneration buffer with some data conversion. However, the 
format of the returned data is different. 


The READ SCREEN TO PRINT WITH GRID LINES command: 
e ls valid for workstations with or without extended attribute support 


e Is valid only for workstations with grid line support. 


e Returns data from the regeneration buffer intermixed with grid line data ina 
format that can be used on a grid-line-capable printer. 


¢ Is valid only in DP mode. 


The command code is X'6A'. 


ESC READ SCREEN TO PRINT WITH GRID LINES) 
X'04' X'6A' 


The 5494 does not clear pending AID requests or queued read commands when it 
processes the READ SCREEN TO PRINT WITH GRID LINES command. The 
state of the keyboard is unaffected by this command. 


The 5494 rejects the READ SCREEN TO PRINT WITH GRID LINES command 
under the same conditions as it rejects the READ SCREEN command. See “READ 
SCREEN Command” on page 15-107. The 5494 also rejects the command if the 
display does not have grid line capability. 


The format of the returned data is similar to that required by SCS printers that 
support grid lines. Current printers only support printing lower grid-line characters. 
For this reason, data is returned such that the upper grid line for row 1 is printed as 
a lower grid line on row O. | 
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A row of data is made up of grid line formatting, plus text. It is in the following 
format: 


Rn LTn LGn 2BFD Cl Sl 00 Tl Gl G2 ...Gn 
2BFD C2 S2 00 T2 Gl G2 ...Gn 


2BFD Cn Sn 00 Tn Gl G2 ...Gn 
Text (if present) 


KEY: 
Rn 1 byte Row Number (X'00' to X'18') 
LTn 2 bytes Total length of the row from the first 2BFD 
LGn 2 bytes Total length of the grid line data from the first 
2BFD (X'0000' indicates no grid line data) 
2BFD 2 bytes Grid line data indication (X'2BFD') 
Cx 1 byte Count of bytes following a 2BFD including 
the Sx, 00, Tx, and all Gx bytes 
Sx 1 byte Grid line style 
X'0O0' Solid line 
X'Q01' Thick Solid line 
X'Q02' Double line 
X'03' Dotted line 
X'04' Dashed line 
X'05' Thick dashed line 
X'Q@6' Double dashed line 
00 Reserved 
TX 1 byte Grid line type 
X'40' Vertical grid line 
X'80' Horizontal grid line 
X'CQ' Vertical and Horizontal grid line 
Gx 1 byte Grid line position (X'01' to X'51') 
Text 80 bytes Text data on screen (if present it is always 80 bytes) 


Note: For each line on the screen, a separate grid line definition is included for 
each unique grid line. For example, if a solid vertical line appears in five positions 
and a double horizontal line underscores 25 positions, then two grid line definitions 
are included in the data stream before the text. 


READ SCREEN TO PRINT WITH EXTENDED ATTRIBUTES AND GRID 
LINES Command 


The AS/400 system issues the READ SCREEN TO PRINT WITH EXTENDED 
ATTRIBUTES AND GRID LINES command to obtain screen data, any non-null 
extended attributes, and grid lines currently on the screen. Like the READ 
SCREEN TO PRINT WITH EXTENDED ATTRIBUTES command, the 5494 
transmits screen data to the AS/400 system from the regeneration buffer with 
extended attributes and with some data conversion. Additionally, interwoven with 
each line of text is grid-line data in a similar format to the READ SCREEN TO 
PRINT WITH GRID LINES command. 


The READ SCREEN TO PRINT WITH EXTENDED ATTRIBUTES AND GRID 
LINES command: 
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e ls valid only for workstations with both extended attribute support and grid line 
support. 


e Returns only meaningful screen data and any non-null extended attributes 
combined with grid line data. : 


e Is valid only in DP mode. 


The command code is X'6C'. 


READ SCREEN TO PRINT WITH EXTENDED 


ATTRIBUTES AND GRID LINES 
X'6C' 





The 5494 does not clear pending AID requests or queued read commands when it 
processes the READ SCREEN TO PRINT WITH EXTENDED ATTRIBUTES AND 
GRID LINES command. The state of the keyboard is unaffected by this command. 


The 5494 rejects the READ SCREEN TO PRINT WITH EXTENDED ATTRIBUTES 
AND GRID LINES command under the same conditions as it rejects the READ 
SCREEN command. See “READ SCREEN Command” on page 15-107. The 5494 
also rejects the command if the display does not have both extended attribute and 
grid line capability. 


The 5494 creates the inbound grid-line data in the same way it does for the READ 
SCREEN TO PRINT WITH GRID LINES command, except for the textual data. 
The textual data is in the same format as the data returned from the READ 
SCREEN TO PRINT WITH EXTENDED ATTRIBUTES command. Trailing nulls are 
truncated and each line has an end-of-line indicator (X'FF'), whether or not text 
exists. 


READ IMMEDIATE Command 


The READ IMMEDIATE command allows the AS/400 system to read the data from 
all input fields defined in the format table without depending on the workstation 
operator to press an AID request key. The command code is X'72'. 


ESC READ IMMEDIATE 
X'04' X'72! 


Processing for this command is the same as the processing for the READ 
SCREEN command, with the exception that the READ IMMEDIATE command 
reads from the format table. 


READ MODIFIED IMMEDIATE ALTERNATE Command 
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The READ MODIFIED IMMEDIATE ALTERNATE command allows the AS/400 
system to read data from modified input fields without depending on the operator to 
press an AID key. The command code is X'83'. 


ESC READ MODIFIED IMMEDIATE ALTERNATE 
X'04' X83! 
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Processing of this command is the same as the processing for the READ 
IMMEDIATE command, except for the following differences in the format of data 
sent to the AS/400 system: 


The 5494 only returns data from those fields in the format table that have the 
MDT bit on. 


The data field is delimited by SBA orders in the same way as the response 
data field fora READ MDT FIELDS command. 


The leading and embedded nulls within the data for each field are not 
converted to blanks. 


Trailing nulls within the data for each field are suppressed. 


SAVE SCREEN Command 


The AS/400 system issues the SAVE SCREEN command to preserve the current 
state of an addressed workstation. The specific data included in the data stream 
sent to the AS/400 system is as follows: 


The contents of the format table 
The contents of the regeneration buffer 
The contents of the grid line buffer if in use. 


The state of video and audio, including PIP location and size, volume setting, 
channel, see-through state, and tuner source if 5250 Video Delivery video or 
audio is in use. | 


The state of the keyboard 

Keystroke processing history 

The current location and state of the cursor 
The code returned in response to the Help key 


The requirement to send LU-LU LUSTAT command when the error line is 
available | 


Any outstanding AID request 
Any outstanding READ command 


Indication of whether the display has an image/fax in memory. 


The following data is excluded from the input data stream: 


The condition of the Shift key and the associated indicator 

The state of the Message Waiting indicator 

The requirement to send SS-LU LUSTAT command if the error line is free 
The current status of the Diacritic, Hex Key, and Command Key modes. 
Image/fax data 


When the 5494 processes a SAVE SCREEN command, it transmits an escape 
character and RESTORE SCREEN command as the first 2 bytes of the input data 

stream. The format and arrangement of the subsequent data depends upon the 
specific type of workstation being used, and the AS/400 system must not change 
this data in any way. 
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The SAVE SCREEN command does the following compression: 


¢ Screen data (including extended attribute data). A series of 4 or more of the 
same characters in the screen image is compressed into a: 
— Flag byte (X'11') 
— Byte containing the repeated character 
— Count byte 
All series of unlike characters appear as they occur. 


Note: If the flag value (X'11') appears in the screen data, it will be preceded 
by a flag and followed by a count (X'111101'). 


¢ Scale line table. The portion of the scale line table in use is returned to the 
AS/400 system preceded by a count byte. 


Ideographic shift-out/shift-in table. The portion of the ideographic 
shift-out/shift-in table in use is returned to the AS/400 system. It is preceded 
by a 2-byte pointer to the beginning of the table. 


The command code is X'02'. 


ESC SAVE SCREEN 
X'04' X'02' 


The 5494 rejects the SAVE command if: 


e |t is not the last command in the SNA chain. 
e The 5494 does not have a CD bit. 


SAVE PARTIAL SCREEN Command 


The AS/400 system issues the SAVE PARTIAL SCREEN command to preserve the 
current (partial) state of an addressed workstation. The command code is X'03'. 


SAVE FLAG BYTE TOP ROW LEFT WINDOW WINDOW 
PARTIAL 00 or COLUMN DEPTH WIDTH 


SCREEN 1 through 25 00 or 00 or 00 or 
X'03' 1 through 126 | 1 through 25 1 through 126 





FLAG BYTE Bit O 


0 = Include image/fax information if image/fax data is on 
the 5250 session (default). 


1 = Do not include image/fax information. Image/fax data 
is not erased from display memory when this screen data 
is restored. 


Bits 1-7 = Reserved (set to zero) 


TOP ROW The row position of the window. It is the same value that is 
specified in the set buffer address (SBA) prior to issuing the 
CREATE WINDOW structured field. Set this parameter to 
X'00' if you want the entire display screen to be saved. 
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LEFT COLUMN The column position of the window. It is the same value that 
is specified in the SBA prior to issuing the CREATE WINDOW 
structured field. Set this parameter to X'00' if you want the 
entire display screen to be saved. 


WINDOW DEPTH _ The number of rows inside the window. It is the same value 
that is specified in the CREATE WINDOW structured field. 
Set this parameter to X'00' if you want the entire display 
screen to be saved. | 


WINDOW WIDTH — The number of columns inside the window. It is the same 
value that is specified in the CREATE WINDOW structured 
field. Set this parameter to X'00' if you want the entire 
display screen to be saved. 


Note: If any of the parameters, top row, left column, window depth, or window 
width, is zero or invalid, the entire display screen is saved. Currently, the 5494 
saves the entire display screen in all cases (ignoring these four parameters). Some 
5250 controllers may process these parameters and save only a portion of the 
display screen if specified in the four parameters. 


The SAVE PARTIAL SCREEN command is similar to the SAVE SCREEN 
command except for: 


e The SAVE PARTIAL SCREEN command does not have to be last in the data 
stream. However, a SAVE SCREEN command, another SAVE PARTIAL 
SCREEN command, or one of the IMMEDIATE READ commands cannot follow 
a SAVE PARTIAL SCREEN command. 


e The 5494 saves the specified data when the SAVE PARTIAL SCREEN 
command is found in the data stream; however, it does not return the save 
data to the AS/400 system until the remainder of the data stream has been 
processed. This is to improve response time performance. This means that 
you can work with the updated screen while the save data is being sent to the 
AS/400 system. 


Note: There are two AS/400-to-5494 exchanges involved in the save process. 
The AS/400 system reads the AID code and performs the save. The AS/400 
system sends the SAVE PARTIAL SCREEN command with the updated 
screen. Then the AS/400 system waits for the save data and returns the 
change direction (CD) bit to the 5494. (The AS/400 application programmer 
should choose to send another pending read after the save data has been 
received.) 


¢ The first 2 bytes of the inbound data are Escape and Restore Partial Screen 
bytes instead of Escape and Restore Screen bytes. 


e Five parameter bytes follow the SAVE PARTIAL SCREEN command that define 
the specific area of the screen that you want to save. For example, a save 
operation can be done before placing a pop-up menu on the screen (it may be 
necessary for you to save only the area of the screen that will contain the 
pop-up menu). 


Warning: If the SAVE PARTIAL SCREEN command specifies that only a portion 
of the display should be saved, either the corresponding RESTORE PARTIAL 
SCREEN command or an entirely new display screen should be sent. 
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RESTORE SCREEN Command 


The AS/400 system issues the RESTORE SCREEN command to return all data 
previously stored as the result of the SAVE command. This command restores all 
aspects of the original workstation state except for the following conditions: 


e The condition of the Shift key and the associated indicator is lost. 
e The state of the Message Waiting indicator is lost. 


e The requirement to send SS-LU LUSTAT command, if the error line is free, is 
lost. 


¢ The current status of the Diacritic, Hex Key, and Command Key modes are 
reset 


e Image/fax data is erased. 


Data is decompressed as necessary and tables are restructured. Compression 
format is described under “SAVE SCREEN Command?” on page 15-113. 


lf the restore data contains an indication that image/fax data was previously being 
displayed, the 5494 sends the Image/Fax Request Aid (X'81') to the AS/400 
system, indicating image/fax data is required but not currently available. It uses the 
outstanding READ command sent by the AS/400 application following the 
RESTORE command. The AS/400 application should respond by sending a data 
stream that includes the following commands: 


1. AWRITE TO DISPLAY command, which unlocks the keyboard. 


2. All IMAGE/FAX CONTROL and DOWNLOAD commands required to completely 
restore the screen. The fax or image should be in the same format as last 
presented (location, size, rotation, scale, and non-display). 


3. A pending READ command. 


The command code is X'12'. The 5494 rejects a RESTORE SCREEN command 
if any additional data stream commands follow the restore data. 


RESTORE Data Previously Stored by SAVE 


SCREEN SCREEN Command 
x'42! 





RESTORE PARTIAL SCREEN Command 


The AS/400 system issues the RESTORE PARTIAL SCREEN command to return 
ail data previously stored as the result of the SAVE PARTIAL SCREEN command. 
The RESTORE PARTIAL SCREEN command restores all aspects of the original 
workstation except for the following conditions: 


e The condition of the Shift key and the associated indicator is lost. 
e The state of the Message Waiting indicator is lost. 


e lf the error line is free, the requirement to send the SS-LU LUSTAT command 
is lost. 


e The current status of the Diacritic, Hex Key, and Command Key modes are 
reset. 
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e Image/fax data may be erased. 


The command code is X'13'. 


RESTORE LENGTH | Data Previously Stored by SAVE PARTIAL 
PARTIAL SCREEN Command 


SCREEN 
X'13' 





LENGTH The length of the restored data (including the 2 length bytes). 


The RESTORE PARTIAL SCREEN command is similar to the RESTORE SCREEN 
command except for: 


¢ The RESTORE PARTIAL SCREEN command does not have to be last in the 
data stream. This enhances response time performance. 


e The length parameter follows the RESTORE PARTIAL SCREEN command and 
specifies the length of the restored data (including the 2 length bytes). 


e The image/fax data is erased from the screen unless the SAVE PARTIAL 
command was used with FLAG byte, bit 0, set to on. If the bit was set to on 
and image/fax data were visible before the RESTORE PARTIAL SCREEN 
command was received, it would still be visible after the command is 
processed. If the bit was set to off, image/fax data is requested from the 
AS/400 system as described in the RESTORE command. 


The RESTORE PARTIAL SCREEN command should always be the first command 
in the data stream (SNA chain). 


ROLL Command 


The ROLL command allows lines to be rolled on the screen. The direction and 
number of lines rolled are specified by the parameters following the ROLL 
command. The command will be rejected with a state error if the addressed 
display: 


e Has no separate message line, or has a separate message line but is using a 
different error line and is in pre-help error, post-help error, system request, or 
SS message state 


e Has a separate message line with the message line selected, and is in system 
request or SS message state 


The command code is X'23'. 


ESC ROLL Parameters 
X'04! X'23' 3 bytes 
Parameter Byte 1: Bit O 0 = Roll up 
1 = Roll down 
Bits 1-2 Reserved 
Bits 3-7 Number of lines that the designated area is to 
be rolled 


Byte 2: Bits 0-7 Line number defining the top line of the area 
that will participate in the roll. 
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Byte 3: Bits 0-7 Line number defining the bottom line of the 
area that will participate in the roll. 


When the 5494 processes a ROLL command, the addressed workstation rolls the 
screen display up or down by the number of lines indicated in the command. 
Although this command does not clear any pending AID requests, affect the state 
of the keyboard, or change the position of the cursor, the following considerations 
limit its use: | | 


e Lines vacated due to ROLL command are not cleared to nulls. 


e This command does not change the format table. Consequently, the ROLL 
command should be avoided when it could produce discrepancies between the 
format table and the display. 


e Data rolled out of the roll area is lost. 
e |f bits 3 through 7 of the ROLL command are all 0, command processing 
results in no change to the display. 
The following conditions cause parameter errors: 
1. A top line of zero 


2. A bottom line greater than the number of display lines, excluding the message 
line. 


3. A top line greater than or equal to the bottom line 


4. Roll area greater than bottom line minus top line. 


WRITE SINGLE STRUCTURED FIELD Command 


The WRITE SINGLE STRUCTURED FIELD (WSSF) command is available in DP 
mode only. The command precedes a single command within the data stream. 
Unlike the WSF command (X'F3'), a WSSF command does not have to be the last 
command in the data stream. The command code is X'F4'. 


ESC WSSF 
X'04' X'F4! 


5250 WSC CUSTOMIZATION Command 


The 5250 WSC CUSTOMIZATION command allows the AS/400 system to 
customize 5494 functions. This command follows a WSSF command (X'04F4'). 
This command remains in effect for any given function until: 


e The 5494 receives another 5250 WSC CUSTOMIZATION command that 
changes the customization of the function. 


e The operator changes customization of the function through local keyboard 
operations. 


e The workstation is turned off and on again. 
Table 15-36 on page 15-119 shows the structure of this command and defines the 


function of each field. Table 15-37 and Table 15-38 show the format of the 
keystroke buffering control minor structure and the cursor control minor structure. 
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Table 15-36. Format of 5250 WSC CUSTOMIZATION Command Major Structure 


Field Designation 
LL (2 bytes) 


C (1 byte) 
T (1 byte) 
F1 (1 byte) 
F2 (1 byte) 


Value 


X'0006' or 


>X'0008' 
X'D9' 
x71" 


Function 


Total length of structured field. 


5250 structured field command class. 
Type code for WSC CUSTOMIZATION command. 
Null flags required. 


Bit 0: 
Bit 1: 


Bit 2: 
Bit 3: 


Bit 4: 
Bit 5: 


Bit 6: 


Bit 7: 


Notes: 


Reserved 


Set enhanced field exit required mode if set to on. If this flag is 
set to on, the 5494 will force the user to exit the field with a 
Field Exit type key for the following conditions: 


e The entry field has been modified by the user. 


e The entry field is numeric only, digits only, or signed 
numeric. 


¢ The field is a right adjust field or signed numeric field 
(implied right adjust). 


Resets enhanced field exit required mode if set to on. 


Sets System/36* mode of operation if set to on. The 5494 will 
process entry field data for READ commands in the same way 
it is processed on workstations attached to the System/36: 


e It returns field data appropriate to the type of READ issued 
for all normal AIDs. 


e (|t returns field data for the READ INPUT FIELDS command 
even if no data has been modified. 


Resets System/36 mode of operation if set to on. 


Set SBA code to X'04' in data returned for READ commands if 
set to logic 1. 


Set SBA code to X'11' in data returned for READ commands if 
set to logic 1. 


Flag bits 5 or 6 should be set only if Bit 2 of the Workstation 
Customization byte in the response to the 5250 QUERY 
command is set to logic 1. This only has meaning for 
ideographic displays with extended ideographic attribute 
support. These flags are ignored for other display types. 


If both bits 5 and 6 are set to zero, the current SBA code 
returned for READ commands remains unchanged. If either bit 
is set to logic 1, bit 7 is ignored and assumed to be set to logic 
0. If both bits 5 and 6 are set to logic 1, then bit 5 is ignored. 


Indicates that customization applies to entire 5494 if set to logic 
1. Otherwise, customization applies only to workstation 
receiving command. 


1. When bits 1—6 are set to on, bit 7 is ignored. 


2. When bits 1—6 are set to on, the customization will be in effect until 
the display is turned off or another 5494 WSC CUSTOMIZATION 
command is received for the display, which resets the customization. 
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Table 15-37. Format of Keystroke Buffering Control Minor Structure 


Field Designation 
L (1 byte) 

| T (1 byte) 

F (1 byte) 


Value Function 
X'03' Minor structure field. 
X'01' Type code for keyboard buffering control minor structure. 


Bits O-4: Reserved; null flags required. 
Bit 5: Indicates change type-ahead state if set to logic 1 


Bit 6: Indicates type-ahead is on if set to logic 1 (and bit 5 set to 1). 
If bit 6 is set to O and bit 5 is set to 1, type-ahead is turned off. 
If bit 5 is set to 0, bit 6 is ignored. 


Bit 7: Indicates that the Attention key is buffered if set to logic 1. 
(See note.) 


Note: Attention key buffering is the default setting in the 5494 and applies only if type-ahead is on (bit 6). If 
type-ahead is off, the Attention key buffering can be invoked if type-ahead is turned on with the Hex + K key 
sequence. Customization of Attention key buffering applies only to the workstation receiving the 5250 WSC 
CUSTOMIZATION command. 


Table 15-38. Format of Cursor Control Minor Structure 


Field Designation 
L (1 byte) 
T (1 byte) 
F (1 byte) 


Value Function 
X'03' Minor structure field. 
X'02' Type code for cursor control minor structure. 


Bits 0-6: Reserved; null flags required. 


Bit 7: Indicates that the cursor will blink if set to logic 1, regardless of 
the cursor blink selection made in WCC byte 1. See 
Table 15-3 on page 15-9. 


IMAGE/FAX CONTROL Command 


AS/400 application programs use the IMAGE/FAX CONTROL command to control — 
the display of image or fax data. This command must follow a WSSF command 
(X'04F4'). 


This command has no effect on the current display address, the keyboard state, the 
cursor position, or the maximum number of entry fields allowed on the 5250 
session. 


The 5494 verifies the major length, class, and type and generates a negative 
response if any are invalid. It also verifies that the display is capable of image/fax 
display and generates a negative response if it is not. 


After the verification, the 5494 sends the IMAGE/FAX CONTROL command to the 
display for processing. If the display finds any error with the command, it reports 
the error to the 5494. In turn, the 5494 sends an AID to the AS/400 application in 
response to the pending READ command. See “Image/Fax Status Aids” on 


page 15-125 for the image/fax AID codes and error reporting information. 


Table 15-39 on page 15-121 shows the structure of this command and defines the 
function of each field. 
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Table 15-39 (Page 1 of 5). Format of IMAGE/FAX CONTROL Command 


Field Designation Value Function 
LL (2 bytes) X'001D'- Total length of structured field 
X'011C' 
C (1 byte) X'D9' 5250 structured field command class 
T (1 byte) X'66' Type code for IMAGE/FAX CONTROL command 
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Table 15-39 (Page 2 of 5). Format of IMAGE/FAX CONTROL Command 
Field Designation Value Function 
F1 (1 byte) Flag byte 1: 

Bit 0 = Cache allowed flag 


0 = erase this image/fax from memory whenever any of the following commands 
are received: 


CLEAR UNIT 

CLEAR UNIT ALTERNATE (without saving image/fax) 

RESTORE 

RESTORE PARTIAL (if image/fax data was indicated in the SAVE PARTIAL) 
Another IMAGE/FAX CONTROL command. 


1 = If the display supports a cache, this image/fax data remains in cache memory 
when the application sends one of the above commands to erase this image/fax 
data. 


Bits 1-3 = Type of image/fax display 
B'000' = Normal display (default) 
B'001' = Transparent display (underlying text may be seen through the image/fax) 


B'010' = Non-display (the image/fax data remains in memory until it is erased). 
All other parameters in this command are ignored. 


B'100' = Previously stored image/fax data is erased from the 5250 session and 
possibly from display memory (see bit 0 previously). All other parameters in this 
command are ignored. 


Notes: 


1. If a new image/fax is to be displayed over existing image/fax data, the existing 
image/fax data should be erased before the new data is defined and 
downloaded. 

2. If the image/fax name in this command does not match an image/fax currently 
in display memory, this command is ignored. 


Bit 4 = Color importance during scaling 


0 = Image/fax is dark foreground on light background. Preserve the dark 
foreground data during scaling. 


1 = Image/fax is light foreground on dark background. Preserve the light 
foreground data during scaling. 


Note: If image/fax data is going to be reversed, set this flag according to the 
Original data. 


Bit 5 = Allow display to control scaling 


0 = The display presents vertical and horizontal scroll bars as needed and allows 
the user to scroll without any interaction with the AS/400 application. 


1 = The display does not present scroll bars. 
Notes: 


1. If the image/fax data completely fits within the Viewport, this flag is ignored. 

2. Scroll bars occupy one row (horizontal) and/or one column (vertical) of the 
Viewport. 

3. If the display does not present scroll bars, it is the AS/400 application’s 
responsibility to provide a scrolling method for the user, if necessary. 


Bit 6 = Reverse image 


0 = Normal image/fax display 
1 = Background and foreground colors are reversed 


Bit 7 = Allow/Inhibit EasyScroll with a mouse 


0 = Allow the primary mouse button to EasyScroll the image/fax 

1 = Do not allow EasyScroll with the primary mouse button. EasyScroll is always 
allowed while holding the ALT key and pressing the primary mouse button. This is 
useful if the application has selectable items behind a transparent image/fax. 
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Table 15-39 (Page 3 of 5). Format of IMAGE/FAX CONTROL Command 


Field Designation Value 
F2 (1 byte) 


Reserved (4 bytes) 


Image Format (2 
bytes) 


Viewport Location 
Row (1 byte) 
Column (1 byte) 


Viewport Size 
Rows (1 byte) 
Columns (1 byte) 


Function 
Flag byte 2: 
Bit O = Duplicate scan lines 
0 = Normal image/fax display 


1 = For Group 3 or 4 fax, each scan line is duplicated. For high-resolution fax 
transmission, characters would otherwise appear flattened on the display screen. 
Setting this flag for other formats besides Group 3 or 4 may or may not result in 
duplicate lines. 


Bit 1 = Allow/Inhibit Trim Magnify Scaling 
0 = Allow the secondary mouse button to Trim Magnify the image/fax data 


1 = Inhibit the secondary mouse button to Trim Magnify. This flag could be used if 
there were no need to scale up the image/fax or if the application were going to 
program the secondary mouse button for another purpose. 


Bits 2-6: Reserved - Must be set to 0 


Bit 7: Reserved for IBM image/fax-capable displays. It is used to download 
compression algorithms. Non-IBM displays should ignore this bit. 


Must be set to 0 
Defines the image/fax format. The IBM-defined image/fax data format values are: 


X'0000' = An unknown IBM-defined format. The display should try to show the image/fax 
using IBM-defined formats. If the format is not recognized, an “unknown 
image/fax format” AID is returned. 

X'0001' = IOCA (The IOCA header defines the compression algorithm.) 

X'0002' = TIFF (The TIFF header defines the compression algorithm.) Only one image is 
supported in a TIFF format. If the TIFF data contains multiple images, the AS/400 
system must create a new TIFF header with a single image. 

X'0003' = PCX 

X'0004' = Stand alone Group 3 Fax compression. The header must contain a 4-byte 
length (not including the length or reserved bytes), plus eight bytes of reserved 
data (set to 0), followed by the Group 3 Fax data. 

X'0005'—X'7FFF' = Reserved. 

X'8000'—X'FFFF'. = Non-IBM defined image format. 


Note: The display ignores the image/fax data in the IMAGE/FAX DOWNLOAD 
command if the data does not match the format specified here. 


Defines the upper-left row and column positions of the image/fax Viewport within the 5250 
session. Minimum values for row and column are 1. The maximum values are 
determined by the size of the current 5250 session (24 rows by 80 columns, for example) 
and the size of the Viewport. If the row or column are invalid, the Viewport is displayed at 
Row 1 Column 1. 


Defines the size in rows and columns of the Viewport. The minimum values are: 


e For non-scrollable image/fax data, the minimum value for both rows and columns is 
X'02'. Non-scrollable data fits completely within the Viewport or has bit 5 of flag byte 
1 set to 1. 


e For scrollable image/fax data, the minimum value for both rows and columns is X'03', 
but the recommended minimum for usability is X'06'. Maximum values are 
determined by the number of rows and columns defined by the 5250 session (24 rows 
by 80 columns, for example). 


Notes: 


1. If the image/fax is smaller than the Viewport, the extra area appears as black 
below and to the right of the image. 


2. If the display adds a scroll bar to the bottom of the image, one row of the Viewport 
size is used for this scroll bar. If the display adds a scroll bar to the left of the 
image, one column of the Viewport size is used for this scroll bar. 


3. If either the row or column value is invalid, the display makes the Viewport as 
small as possible. If the Viewport would extend beyond the last row or column of 
the 5250 session, the Viewport is positioned at Row 1 Column 1. 
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Table 15-39 (Page 4 of 5). Format of IMAGE/FAX CONTROL Command 


Field Designation Value 


Scaling (2 bytes) 


View Image 
Location (2 bytes) 
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Function 


This parameter defines the scaling for image/fax data. Valid values are: 


A specific percentage (for example, X'0032' is 50%, X'0064' is 100%) based on the 
originally downloaded image/fax data. The minimum and maximum scaling 
percentages are 3% and 400%, respectively. 


X'FFFF' = No change. This allows the application to move the Viewport, for example, 
without changing the previously defined scaling. 


X'FFFE' = No Scroll Bar Scaling. The data is scaled such that it fits within the 
Viewport without requiring scrolling in either direction. 


X'FFFD' = Fill Scaling. The data is scaled such that it fits horizontally within the 
Viewport without requiring horizontal scroll bars. 


X'FFEa' = Decrement Scaling Values. The value a may be set from 1 to 9 and 
indicates the number of decrement scaling steps. Each step should cause 
approximately a 25% scale down. Decrement scaling can be used until the minimum 
scaling percentage is reached. | 


X'FFDa' = Increment Scaling Values. The value a may be set from 1 to 9 and 
indicates the number of increment scaling steps. Each step should cause 
approximately a 33% scale up. Increment scaling can be used until the maximum 
scaling percentage is reached. 


Notes: 


1. If this parameter is set larger than X'FOOO' and not to a defined value, a value of 
X'0064' is used. 


2. If the application specifies a percentage not supported by the display, the nearest 
supported percentage is used. 


3. If this is the first IMAGE/FAX CONTROL command for this data, and No Change, 
Increment, or Decrement is selected for this parameter, a value of X'0064' is 
used. 


4. If No Scroll Bar Scaling is requested and the entire image cannot fit within the 
Viewport when scaléd to the smallest percentage, scroll bars may be required 
(unless bit 5 of flag byte 1 is set to 1). 


5. If Fill Scaling is requested and the entire image cannot fit horizontally within the 
Viewport using the smallest scaling percentage, scroll bars may be required 
(unless bit 5 of flag byte 1 is set to 1). 


This parameter is used when the image/fax data does not fit within the Viewport. It 
defines the original vertical and horizontal position of the data to be viewed. Byte 1 
defines the vertical percentage and Byte 2 defines the horizontal position. If bytes 1 and 2 
are set to X'FFFF', no change is made to the viewing location. 


Examples: 


X'0000' defines the upper-left corner. 
X'3200' defines the left-most portion, halfway down the image. 
X'6464' defines the lower-right portion. 


X'FFFF' indicates no change to the viewing location. 


Notes: 


1. 


If X'FFFF' is specified on the first IMAGE/FAX CONTROL command, a value of 
X'0000' is used. 


2. The location always indicates the position after rotation and scaling. 


3. If the data is not scrollable in a direction, the corresponding location byte is ignored. 
4. If this value is not X'FFFF' and either byte is greater than 100%, a value of X'0000' 


is used. 


Table 15-39 (Page 5 of 5). Format of IMAGE/FAX CONTROL Command 


Field Designation Value 
Rotation (2 bytes) 


Foreground Color 
(1 byte) 
Background Color 
(1 byte) 


Reserved (2 bytes) 


Name Length (2 
bytes) 


Image/Fax Name 
(1-256 bytes) 


Function 
This parameter defines the clockwise rotation in degrees of the original image/fax data. 
Examples: 
X'0000' = The image is not rotated. 
X'005A' = The image is rotated 90 degrees. 
X'00B4' = The image is rotated 180 degrees (upside down). 
X'010E' = The image is rotated 270 degrees 
Notes: 
1. For a value greater than 359 degrees, a value of X'0000' is assumed. 


2. The display rounds the value to the nearest supported rotating factor. (See Byte 17 of 
the Device Capabilities entry in Table 15-48 on page 15-133 for information on 
possible display rotating factors.) 


These parameters define the foreground and background color of the image/fax data. 
Monochrome displays ignore these fields. Valid values are: 


X'00' = Use default color. For foreground, the default color is generally black. For 
background, the default color is generally white. 


X'80' = White 

X'81' = Black 

X'82' = Blue 

X'83' = Alternate Blue 
X'84' = Green 


X'85' = Alternate Green 
X'86' = Turquoise 
X'87' = Alternate Turquoise 


X'88' = Red 

X'89' = Alternate Red 
X'8A' = Pink 

X'8B' = Alternate Pink 
X'8C' = Yellow 


X'8D' = Alternate Yellow 
Note: If other values are specified, a value of X'00' is assumed. 
Must be set to X'0000'. 


The length of the image/fax name, not including these 2-length bytes. If the length is 
invalid, the display ignores this IMAGE/FAX CONTROL command. 


The application-defined name for specific image/fax data. The same name must be used 
in the IMAGE/FAX DOWNLOAD command and for any additional IMAGE/FAX CONTROL 
commands that refer to this same data. Valid characters are X'00', X'1C', and 
X'40'-X'FE'. Other values may cause unpredictable errors. — 


Note: For displays that support a single image/fax: When an IMAGE FAX CONTROL 
command is received with a different image/fax name, any current image/fax data is 
discarded and a corresponding IMAGE/FAX DOWNLOAD command is expected. 


image/Fax Status Aids 

Image/fax status must be reported back to the AS/400 application which is 
displaying the image/fax data. Aids are normally used to indicate a user has 
pressed a keystroke such as Enter, Help, or a Command key. These image/fax 
aids are generated when the display or 5494 wants to communicate information to 
the AS/400 application. No entry field data is returned with these aids, which also 
use the outstanding READ command as other aids do. | 


The image/fax aid values are: 


e X'81' = Image/Fax Request Aid 
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This aid is generated after a RESTORE command completes and image/fax 
data is required to complete the 5250 session. See “SAVE SCREEN 
Command” on page 15-113 and “RESTORE SCREEN Command” on 

page 15-116 for further information. 


¢ X'82' = Unknown Image/Fax Format Aid 


The display does not support the decompression of the image format specified 
in the Image Format bytes of the IMAGE/FAX CONTROL command. The 
values sent in the Image Format are returned in the cursor row and cursor 
column bytes which precede the aid byte. 


¢ X'83' = Image/Fax Error Reporting Aid 


An error occurred when processing the IMAGE/FAX CONTROL command or 
the IMAGE/FAX DOWNLOAD command. Additional information is returned in 
the cursor row and cursor column bytes which precede the aid byte: 


X'0001' Image/fax data was too large. Only the first portion of the data is 
displayed. 

X'0002' Image/fax data was too large. The data was ignored. 

X'0003' Invalid major length in the IMAGE/FAX CONTROL command 

X'0004' Invalid major length in the IMAGE/FAX DOWNLOAD command 

X'0005' Error in the IMAGE/FAX CONTROL command 

X'0006' Error in the IMAGE/FAX DOWNLOAD command 

X'0007' Error detected in the image/fax data 


IMAGE/FAX DOWNLOAD Command 
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An AS/400 application program uses the IMAGE/FAX DOWNLOAD command to 
send image/fax data to a display. This command must follow a WSSF command 
(X'04F4'). 


The 5494 can support a data stream of up to 16000 bytes. However, for 
performance reasons, it is recommended that the image/fax data be broken up into 
approximately 5000-byte (or smaller) pieces. Multiple IMAGE/FAX DOWNLOAD 
commands may be used to send all the image/fax data. 


Note: The 3489 image/fax buffer size is 128000 bytes. 


This command has no effect on the current display address, the keyboard state, the 
cursor position, or the maximum number of entry fields allowed on the 5250 
session. 


The 5494 verifies the major length, class, and type, and generates a negative 
response if any are invalid. It verifies that the display is capable of image/fax 
display and generates a negative response if it is not. Finally, it generates a 
negative response if this is not the last command in the data stream and the last 
part of the image/fax data is not included in this command. 


After the verification, the 5494 sends the IMAGE/FAX DOWNLOAD command to 
the display for processing. If the display finds any error with the command, it 
reports the error to the 5494. The 5494, in turn, sends an aid to the AS/400 
application in response to the pending READ command. See “Image/Fax Status 
Aids” on page 15-125 for the image/fax aid codes and error-reporting information. 


Table 15-40 on page 15-127 shows the structure of this command and defines the 
function of each field. | 
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Table 15-40. Format of IMAGE/FAX DOWNLOAD Command 


Field Designation 
LL (2 bytes) 


C (1 byte) 
T (1 byte) 
F1 (1 byte) 


Reserved (5 bytes) 
Name Length (2 bytes) 


Image/Fax Name (1-256 


bytes) 


Image/fax data (1-10 225 
bytes) 


Value Function 

X'OQOOE '— Total length of structured field 

X'27FE' 

X'D9Y' 5250 structured field command class : 

X'67' Type code for IMAGE/FAX DOWNLOAD command | 
Flag byte 1: 


Bit O = Last Data Stream flag 


0 = Additional IMAGE/FAX DOWNLOAD commands follow, containing 
data for this image/fax. 


1 = This is the last or only IMAGE/FAX DOWNLOAD command for this 
image/fax. 


Bits 1-7 = Reserved (set to 0) 
Set to 0. 


The length of the image/fax name, not including these 2-length bytes. If the 
length is invalid, the display ignores this IMAGE/FAX DOWNLOAD command. 


The application-defined name for specific image/fax data. The same name must 
be used in the IMAGE/FAX CONTROL command sent previously. 


Note: If no matching name was sent in a previous IMAGE/FAX CONTROL 
command, this command is ignored. 


Actual image/fax data in the format described in the IMAGE/FAX CONTROL 
command. A data length of no more than 5000 bytes is recommended, but as 
many as 10225 bytes can be sent. 


Video/Audio Controls Command Major Structure 


AS/400 application programs use the Video/Audio Controls command to control the 
video and audio of a PC/TV (or equivalent) attached to a capable display such as 
the IBM InfoWindow II 3489. This command must follow a WSSF command 
(X'04F4'). 


Other 5250 Display Data Stream commands and orders can precede and follow the 
Video/Audio Controls command. A 5250 Display Data Stream can contain multiple 
Video/Audio Controls commands. 


The 5494 verifies the major length, class, and type and generates a negative 
response if any are invalid. It verifies that the display is capable of 5250 Video 
Delivery and generates a negative response if it is not. It also verifies that the first 
two bytes of the PC/TV command are X'E201' or X'E301' and generates a 
negative response if they are not. It does not validate the remaining 4 bytes. 


lf the command appears valid to the 5494, it sends the 6-byte PC/TV command to 
the display for processing. If the display receives an invalid command, it will reset 
and return to a sign-on screen. 


Table 15-41 shows the structure of this command and defines the function of each 
field. 

Table 15-41 (Page 1 of 2). Format of the Video/Audio Controls Major Structure 

Field Designation Value Description 


LL (2 bytes) X'OOOB' Length of structured field in bytes 
including length bytes 
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Table 15-41 (Page 2 of 2). Format of the Video/Audio Controls Major Structure 


Field Designation Value Description 

C (1 byte) X'D9Q' 5250 structured field command 
class 

T (1 byte) X'68' Type code for Video/Audio 
Controls Command 

Fi (1 byte) X'00! Reserved 

Data (6 bytes) PC/TV See Table 15-42 for supported 

Command commands. 


Table 15-42 (Page 1 of 3). PC/TV Commands 


Command Value Function Details 
Set View Mode to X'E20113000001 ' Turns on the PC/TV video using the stored 
PIP channel value, in Picture-In-Picture (PIP) 


mode. The location and size of the PIP 
video is generally determined by the last 
setting of Set PIP Location and Size PC/TV 
command (keyboard-driven control can 
change location and size of the PIP). This 
PC/TV command is ignored if PIP is already 


active. 

Set View Mode to X'E20113000000' —*‘ Turns off PC/TV video. This PC/TV 

Off | command is ignored if video is already off. 

Turn Audio On X'E20114000000' Turns on the PC/TV audio using the stored 
channel value; the stored volume setting is 
used. 

Turn Audio Off X'E20114000001 ' Turns off the PC/TV audio. 

Set PC/TV Volume X'E2010C0000pp ' pp defines the percentage value of the 


volume: 0% to 100% (X'00'—X'64'). If the 
volume (pp) is changed to a different value 
by this PC/TV command and audio was off, 
then audio will be turned on. If the volume 
(pp) is the same as the previous volume 
setting, audio off/on state will not be 
affected by this PC/TV command. 


Set PIP Location and X'E3801RRCCrrcc' Defines PIP location and PIP size. RRCC 

Size sets the location of the PIP video on the 
display screen. RR is the upper left row of 
the video from 1 to 27 (X'01'-X'1B'). CC 
is the upper left column of the video from 1 
to 132 (X'01'-X'84'). rrcc sets the 
number of rows and columns within PIP 
video area. rr is the number of rows in the 
PIP area from 1 to 27 X'01'—X'1B'). cc 
is the number of columns in the PIP area 
from 1 to 132 (X'01'-X'84'). If PIP video 
is not currently active, the PIP location and 
size values are stored for later use. 


Set PIP See X'E2011F000001 ' Characters, text cursor, and mouse pointer 

Through On behind the PIP video will be somewhat | 
visible through the video. If PIP video is not 
active, PIP See Through On is stored for 
later use. 
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Table 15-42 (Page 2 of 3). PC/TV Commands 


Command 


Set PIP See 
Through Off 


Freeze PIP 


Resume After 
Freeze 


Set PC/TV Channel 


Set Antenna Tuner 
Source 


Set Cable Tuner 
Source 


Disable Internal 
Speaker 


Enable Internal 
Speaker 


Keyboard Disable 


Keyboard Enable 


Set PC/TV 
Brightness 


Value 
X'E2011FO00000' 


X'E20120000001 ' 


X'E20120000000 ' 


X'E201120000cc' 


X'E20111000000' 


X'E20111000001 ' 


X'E20121000001 ' 


X'E20121000000 ' 


X'E20117000001 ' 


X'E20117000000' 


X'E2010D0000pp' 


Function Details 


Turns PIP See Through off. Characters, 
text cursor, and mouse pointer behind the 
PIP video will not be visible. If PIP video is 
not active, See Through Off is stored for 
later use. 


Freezes the current video in the PIP. If PIP 
video is not active, PIP freeze mode is 
stored until PIP is started. 


Restarts the PIP video after a Freeze PIP 
PC/TV command. If PIP video is not active, 
PIP freeze mode is still turned off. 


cc defines the channel to be presented. For 
cable source, 0 to 126 (X'00'—X'7E') are 
valid. For antenna source, 0, 2 to 69, and 
126 (X'00', X'02'-X'45', and X'7E') are 
valid. A value of 126 is used for an external 
source for both cable and antenna sources. 
If O is not a valid antenna or cable channel, 
O is used as an external source also. If 
video or audio is not active, the channel 
value is stored for later use. 


Sets the tuner to expect antenna source. 
Sets the tuner to expect cable source. 


Disables the internal speaker and the 
headphone jack. 


Enables the internal speaker and the 
headphone jack. This will undo the effect of 
a Disable Internal Speaker PC/TV 
command. 


Inhibits keyboard-driven PC/TV control. The 
3489 will not allow the user to press the key 
sequence (Alt-Setup) to get into 
keyboard-driven PC/TV control mode. This 
command will be processed by the 3489 
and will not be passed through to the 
PC/TV. | 


Enables keyboard-driven PC/TV control. 
The 3489 will allow the user to press the 
key sequence (Alt-Setup) to get into 
keyboard-driven PC/TV control mode. This 
command will be processed by the 3489 
and will not be passed through to the 
PC/TV. This command will undo the effect 
of the Keyboard Disable PC/TV command. 


pp defines the percentage value of the 
brightness: 0% to 100% (X'00'—X'64'). If 
video is not active, brightness is stored for 
later use. 
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Table 15-42 (Page 3 of 3). PC/TV Commands 

Command Value Function Details 

Set PC/TV Color X'E2010FO0000pp' pp defines the percentage value of the 
color: 0% to 100% (X'00' - X'64').- If video is 
not active, color is stored for later use. 

Set PC/TV Contrast X'E2010E0000pp ' pp defines the percentage value of the 


contrast: 0% to 100% (X'00' - X'64'). If video 
is not active, contrast is stored for later use. 


Set PC/TV Tint X'E2011000pppp ' pppp defines the percentage value of the 
tint: -100% to 100% (X'FF9C'—X'FFFF' or 
X'0000'—X'0064'). If video is not active, 
tint is stored for later use. 


WRITE STRUCTURED FIELD (WSF) Command 


The WRITE STRUCTURED FIELD (WSF) command introduces a data field into the 
SNA flows whose internal structure differs from those previously described. The 
AS/400 system uses this type of data structure to support the following operations: 


e 5250 pass-through display support 
e Receipt of NWS functional information 
e Control over workstations during text support operation. 


The command code is X'F3'. 


ESC WSF Structured Field Structured Field 
X'04' X'F3' 


The format of data returned to the AS/400 system in response to a WSF command 
is: 


The contents of the Row, Column, and AID Code fields are determined by the type 
of information in the structured field. When structured fields are used for text 
support, the Row and Column fields define cursor location, and the AID Code field 
indicates which AID key the workstation operator pressed. When cursor location is 
not relevant to the contents of the structured field, these fields are set to 0 
(X'0000'), and the AID Code is used as follows: 


e X'FF'-~Identifies a pass-through data stream reply | 
e X'88'—Identifies a 5250 QUERY reply or a 5250 QUERY STATION STATE 


reply. 7 
The architecture governing structured fields defines several different control fields; 
the 5494 recognizes the following control fields: 


LL-— A 2-byte field that identifies the total length of the structured field, including 
the length bytes. 


C-— A 1-byte class code that supplies a first level of command identification. 


T— A 1-byte type code that supplies a second level of command identification. 
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PS 
— 


A 1-byte partition subaddress field (always X'00'). 


A 0O- to 3-byte field containing format control flags. 


A 1-byte field that indicates the revision level of a table identified by the C 
and T fields. 


Any particular structured field is a construct assembled from several control fields 
and a data field of varying length. The 5494 accepts the following constructs as 
valid formats for structured fields: 


LL C 


LL C 


Data Field 


Data Field 


Data Field 


4 


FF Data Field 


LL C FFF Data Field 


3) f= 


The following sections identify specific functions associated with each of these 
structured field formats. 


Table 15-43 lists the c and ft fields, the description, and the table location of each 
structured field format. Use the c and t fields as the index. 


Table 15-43 (Page 1 of 2). Structured Field Formats Quick Reference Table 


c Field 


X'D9Y' 
X'DY! 


X'D9' 
X'DY! 
X'D9' 
X'D9Y! 
X'DY! 
X'DY! 


X'D9" 


X'D9g' 


X'D9' 


t 


Field 
X'30' 
X'31' 


X'32' 
X'33'! 
X'34! 
X'35' 
X'36' 
X'37' 
X'38' 
X'39' 


X'3A!' 


Description 


DEFINE AUDIT WINDOW TABLE 


DEFINE COMMAND KEY 
FUNCTION 


READ TEXT SCREEN 
DEFINE PENDING OPERATIONS 
DEFINE TEXT SCREEN FORMAT 
DEFINE SCALE LINE 


WRITE TEXT SCREEN 


DEFINE SPECIAL CHARACTERS 
PENDING DATA 


DEFINE OPERATOR ERROR 
MESSAGES 


DEFINE PITCH TABLE 


Chapter 15. 


See 


Table 
Table 


Table 
Table 
Table 
Table 
Table 
Table 
Table 
Table 


Table 


15-51 on page 
15-52 on page 


15-53 on page 
15-56 on page 
15-57 on page 
15-58 on page 
15-59 on page 
15-61 on page 
15-62 on page 
15-63 on page 


15-64 on page 


Display Data Streams 


15-140 
15-141 


15-142 
15-144 
15-145 
15-146 
15-147 
15-150 
15-150 
15-152 


15-152 


15-131 


Table 15-43 (Page 2 of 2). Structured Field Formats Quick Reference Table 


c Field t 
Field 
X'D9! X'3B' 
X'Dg'! X'3F' 
X'D9g' X'70' 
X'D9' X'72! 


Description See 

DEFINE FAKE DP COMMAND Table 15-65 on page 15-153 
KEY FUNCTION : 
PASS-THROUGH Table 15-44 on page 15-132 
5250 QUERY Table 15-47 on page 15-133 
5250 QUERY STATION STATE Table 15-49 on page 15-139 


iiceecidaibciai Workstation Support 
The 5494 can support operation of a 5250 pass-through workstation. This 
workstation can process keystrokes, maintain a format table, and decode 
commands received from the AS/400 system. Table 15-44 shows the fields 
required to support communications and defines the functions. Table 15-45 shows 
the fields in pass-through responses. 


Table 15-44. Structure of Pass-Through Commands 


Field Designation Value 

LL (2 bytes) ~X'0006' to 
-X'0819' 

C (1 byte) X'D9' 

T (2 bytes) X'3F! 

DATA 


Function 


Total length of structured field. 


5250 structured field command class. 
Type code for transfer data from AS/400 system. 


The pass-through data stream consists of a 2-byte LL field followed by 
up to X'0800' bytes of data. The 5494 does not check either the 
validity of this LL field or the internal structure of the data field. 


Table 15-45. Structure of Pass-Through Responses 


Field Designation Value 

LL (2 bytes) X'0002' to 
X'089A' 

DATA 


15-132 Functions Reference 


Function 


Total length of response structured field. 


This field contains up to X'0898' bytes of data formatted by the 
pass-through display. The 5494 does not check the internal structure of 
this data. 


5250 QUERY Command 


The AS/400 system issues the 5250 QUERY command to obtain information about 
the functional capabilities of an NWS attached to the 5494. When the 5494 
receives this command, it returns a 5250 QUERY reply to the AS/400 system. 


The 5250 QUERY command is valid for both the DP and WP modes, and it can be 
sent any time that an attached NWS is in session with the AS/400 system. When a 
5250 QUERY command is sent to a workstation, the AS/400 system must configure 
the command at the end of an SNA chain, and the LU must receive a CD 
indication. If the command is sent to a printer, the AS/400 system must configure 
the command as a single RU with CD. Table 15-46 and Table 15-47 show the 
structure of 5250 QUERY commands and responses. Table 15-48 shows the 
contents of a 5250 QUERY response data field. 


Table 15-46. Structure of the 5250 QUERY Command 


Field Designation 
LL (2 bytes) 

C (1 byte) 

T (1 byte) 

F1 (1 byte) 


Value Function 

X'0005' Total length of structured field 
X'D9Y! 5250 structured field command class 
X'70' Type code for query function 

X'00! Null flags are required 


Table 15-47. Structure of the 5250 QUERY Response 


Field Designation 
LL (2 bytes) 

C (1 byte) 

T (1 byte) 

F1 (1 byte) 

Data Field 


Value Function 

X'0044' Total length of structured field 

X'DY' 5250 structured field command class 
X'70' Type code for query function 

X'80' Fixed code for a 5250 QUERY response 


This field contains. parameters that define the characteristics of a 
designated LU. See Table 15-48 for detailed field definitions. 


Table 15-48 (Page 1 of 6). Structure of the 5250 QUERY Response Data Field 


Field Designation 
Workstation Control Unit 


Code Level 


Reserved field (16 bytes) 


Workstation Type Code 
(1 byte) 


Machine Type Code 
(4 bytes) 


Model Number (3 bytes) 
Keyboard ID (1 byte) 


Value Function 
X'0043' Identifies the controller as a 5494 
Identifies the code release level as: 
X'040310'—Release 3.1 
Nulls required 
Identifies workstation type as: 


X'01'—display station 
X'02'—printer 


Contains an EBCDIC code for the machine type 


Contains an EBCDIC code for the machine model number 


Device code for standard 5250 keyboards (X'00' printers) 
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Table 15-48 (Page 2 of 6). Structure of the 5250 QUERY Response Data Field 


Field Designation Value 


Extended 
Keyboard ID (1 byte) 


Reserved (1 byte) 
Serial Number (4 bytes) 


Input Fields (2 bytes) X'0100' 


Control Unit 
Customization 
(1 byte) 


Reserved Field (2 bytes) 


Device 
Capabilities (22 bytes) 
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- Function 


Device code for extended 5250 keyboards (X'00' for printers) 


Set to X'00' 


Field for device serial number. This field is set to zero for workstation 
with no serial number. 


Field that indicates the maximum number of input fields available (256). 


Field that indicates customization parameters as: 


Bit 0: Indicates that the AS/400 system can send a 5250 WSC 
CUSTOMIZATION command when set to logic 1 


Bit 1: Indicates that the AS/400 system can send a 5250 QUERY 
STATION STATE command when set to logic 1 


Bit 2: Indicates that the AS/400 system can send a 5250 
WORKSTATION CUSTOMIZATION command to select the SBA 
code returned in READ commands for displays with ideographic 
extended attributes when set to logic 1. 


Bit 3: Indicates the 5250 WORKSTATION CUSTOMIZATION 
command may be 6 bytes or greater than 8 bytes in length when set 
to logic 1. 


Bits 4—7: Reserved. 


Nulls required 


This field defines the operating capabilities of the designated LU as: 
Byte 0 (X'00' for printers) 


Bits 0-1: Indicate Row 1/Column 1 support as: 
B'0Q0O' no support 
B'01' limited support 


Bit 2: Indicates the READ MDT ALTERNATE command is supported 
when set to logic 1 


Bit 3: Indicates the workstation and 5494 have PA1 and PA2 
support when set to logic 1 


Bit 4: Indicates the workstation and 5494 have PAS support when 
set to logic 1 


Bit 5: Indicates the workstation and 5494 have cursor select support 
when set to logic 1 . 


Bit 6: Indicates 5494 has Move Cursor order, Transparent Data 
order and Transparent entry field FCW support when set to logic 1 


Bit 7: Indicates the READ MODIFIED IMMEDIATE ALTERNATE 
command is supported when set to logic 1 


Table 15-48 (Page 3 of 6). Structure of the 5250 QUERY Response Data Field 


Field Designation Value Function 


Byte 1—display screen capabilities 


Bit 0: Reserved 

Bit 1: Reserved 

Bit 2: Indicates 27 x 132 screen size is supported when set to logic 
1 

Bit 3: Indicates 24 x 80 screen size is supported (always set to logic 
1) 

Bit 4: Indicates SLP is supported when set to logic 1 

Bit 5: Indicates MSR is supported when set to logic 1 

Bits 6—7: Define color support as: 

B'00' monochrome display 

B'01' color support 


Byte 2 


Bit 0: Indicates text symbols support when set to logic 1 

Bit 1: Indicates workstation and 5494 have extended primary 

attribute support in WP mode when set to logic 1 

Bits 2-4: Indicate Office Editor/Text support as: 

B'000' no Office Editor/Text support 

B'001' single language Office Editor/Text support 

B'010' dual language Office Editor/Text support 

Bit 5: Indicates workstation and 5494 have extended primary 

attribute support in DP mode when set to logic 1 

Bits 6-7: Indicates extended foreground color attribute support 

B'00' No extended foreground color attribute support 

B'01' Available in DP mode. Fourteen colors are defined, but 
only 7 are available. The other 7 colors are mapped into 
the available colors. 

B'10' Available in DP mode. Fourteen colors are supported. 


Byte 3 


Bits 0-2: Indicate ideographic capability as: 

B'000' no ideographic capability 

B'001' ideographic capability for presentation screen only 

B'010' Presentation screen ideographic capability and extended 
ideographic attribute support 

Bits 3-5: Indicate bidirectional support as: 

B'000' no bidirectional capability 

B'001' bidirectional capability 

Bit 6: Ideographic SO and SI characters may require an entry in the 

FFT when set to logic 0. Ideologic SO and SI characters do not 

require an entry in the FFT when set to logic 1. 

Bit 7: Reserved 
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Table 15-48 (Page 4 of 6). Structure of the 5250 QUERY Response Data Field 


Field Designation 


15-136 Functions Reference 


Value Function 
Byte 4 


Bits 0-2: Indicate graphics capability as: 

B'000' no graphics capability 

B'001' 5292-style graphics 

B'010' GDDM*-OS/2 Link Graphics 

Bit 3: Indicates extended 3270 data stream capability when set to 
logic 1 

Bit 4: Indicates pointer device (mouse) available when set to logic 1 
Bit 5: Indicates GUI-like characters available when set to logic 1 
Bit 6: Indicates 5494 supports enhanced user interface level 1 
commands and FCWs when set to logic 1 (See note on page 
15-139.) : 

Bit 7: Indicates WRITE ERROR CODE TO WINDOW command is 
supported when set to logic 1. 


Byte 5 


Bit 0: Indicates enhanced user interface support level 2 including 
the Write Data and Programmable Mouse Buttons structured field 
commands, the Word Wrap FCW, and ideographic continued entry 
fields are supported when set to logic 1. 

Bit 1: Indicates this is a GUI device that uses all-points-addressable 
constructs for windows, selection fields, and scroll bars, when set to 
logic 1. 

Bit 2: Indicates WordPerfect support is available within the Office 
Editor when set to logic 1. 

Bit 3: Indicates dynamic status line and scale line support is 
available within the Office Editor when set to logic 1. 

Bit 4: Indicates enhanced user interface support level 3 including 
enhancements to Define Selection Field which does not allow 
pushbutton boxes on a per choice basis, window footers, and left 
and right justified window titles and footers when set to logic 1. 

Bit 5: Indicates cursor draw is supported within the Office Editor 
when set to logic 1. 

Bits 6-7: Indicate 5250 Video Delivery capability 

B'00' no video delivery capability 

B'01' 5250 Video Delivery capable 


Byte 6: Reserved 


Table 15-48 (Page 5 of 6). Structure of the 5250 QUERY Response Data Field 


Field Designation 


Value 


Function 
Bytes 7-8: 5250 Image/Fax Support 


Bits Meaning 

0-13 Reserved 

14-15 00 = No 5250 Image/Fax support 
01 = Support for 7 formats: 


e TIFF 
— No compression 


— CCITT Group 3 fax one-dimensional, modified 
Huffman run length encoding 


CCITT Group 3 fax compression 
— CCITT Group 4 fax compression 


PackBits run length encoding 
e PCX monochrome format 
e Stand-alone CCITT Group 3 fax compression 


11 = Support for the previous 7 formats, plus 5 additional 
formats: 


¢ IOCA 
IBM MMR (Modified CCITT Modified Read) algorithm 


— No compression 


— CCITT Group 3 fax one-dimensional, modified 
Huffman run length encoding 


— CCITT Group 3 fax compression 
CCITT Group 4 fax compression 


Byte 9: Reserved for use by PC Emulators to indicate additional 5250 
Image/Fax Formats supported. | 


Byte 10 


e Bit 0: Indicates printer type as: 
B'0' SCS printer 
B'1' IPDS printer 
e Bits 1-7: Reserved - 
Byte 11: Reserved 


Byte 12: Number of grid line buffers supported. If equal to 00, then grid 
lines are not supported. 


Byte 13: Type of grid line support 


X'00' = grid lines are not supported 
X'01' = type 1 grid line support including support for grid line 
commands 


Byte 14: Reserved 


Byte 15: Number of Fax or Images which can be presented on a 
display screen. 


X'00' No 5250 Image/Fax support 
X'01'-—X'FE' Number allowed 
X'FF' Variable, dependent on the size of the image/fax 
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Table 15-48 (Page 6 of 6). Structure of the 5250 QUERY Response Data Field 


Field Designation 


15-138 


Functions Reference 


Value 


Function 
Byte 16: 5250 Image/Fax scaling granularity 


X'00' No 5250 Image/Fax support 

X'01' Support for scaling percentages from 3% to 400%. No scroll bar 
scaling, fill scaling, no change scaling, increment (about 133%) 
and decrement (about 75%). 

X'02'-X'7E' Reserved 

X'7F' Support for continuous scaling 

X'80'-X'FF' Reserved for use by 5250 PWS emulators. 


Byte 17: 5250 Image/Fax rotating granularity 


X'00' No 5250 Image/Fax support 

X'01' Support for rotation of 0, 90, 180, and 270 degrees. 
X'02'-X'7E' Reserved 

X'7F' Support for continuous rotation 

X'80'—X'FF' Reserved for use by 5250 PWS emulators 


Byte 18: 5250 Image/Fax support 
X'00' No 5250 Image/Fax support 
Bit 0 
0 = Image/fax data always covers textual data. 


1 = Pop-up and pull-down windows which were written 
after image/fax data are presented over image/fax data. 


Bit 1 
0 = Image/fax data always covers textual data. 


1 = This device supports transparent mode. Textual 
data is visible through image/fax data. 


Note: Transparent mode is specified in the IMAGE/FAX 
CONTROL command. 


Bits 2-7 = Reserved 
Bytes 19-21 = Reserved 


Note: 
The commands include: 


CREATE WINDOW Structured Field 

UNRESTRICTED WINDOW CURSOR MOVEMENT Structured Field 
DEFINE SELECTION FIELD Structured Field 

DEFINE SCROLL BAR FIELD Structured Field 

REMOVE ALL GUI CONSTRUCTS Structured Field 

¢ REMOVE GUI WINDOW Structured Field 

¢ REMOVE GUI SELECTION FIELD Structured Field 

e REMOVE GUI SCROLL BAR FIELD Structured Field 

READ SCREEN TO PRINT Command 

READ SCREEN TO PRINT WITH EXTENDED ATTRIBUTES Command 
WRITE ERROR CODE TO WINDOW Command 

SAVE PARTIAL SCREEN Command 

RESTORE PARTIAL SCREEN Command. 


The FCWs include: 
e Continued 
¢ Cursor Progression 
¢ Highlighted 
e Mouse Selection. 


5250 QUERY STATION STATE Command 


The AS/400 system issues the 5250 QUERY STATION STATE command to obtain 
information about the customization state of the addressed workstation. When the 
5494 receives this command, it returns a 5250 QUERY STATION STATE reply to 
the AS/400 system. 


The 5250 QUERY STATION STATE command is valid for both the DP and WP 
modes, and it can be sent any time that an attached 5250 device is in session with 
the AS/400 system. When a 5250 QUERY STATION STATE command is sent to a 
workstation, the AS/400 system must configure the command at the end of an SNA 
chain, and the LU must receive a CD indication. Table 15-49 shows the structure 
of the 5250 QUERY STATION STATE command. Table 15-50 on page 15-140 
shows the structure of the 5250 QUERY STATION STATE response. The 
response is in the same format as the 5250 WSC CUSTOMIZATION command, so 
the data can be used to restore any customization parameters at a later time if 
desired. : 


Table 15-49 (Page 1 of 2). Structure of the 5250 QUERY STATION STATE Command 


Field Designation 
LL (2 bytes) 

C (1 byte) 

T (1 byte) 

F1 (2 bytes) 


Value Function 

X'0006 ' Total length of structured field. 

X'D9' 5250 structured field command class. 

X'72' Query station state command type. 

Bit 0 Must be set to off to indicate this is the command. If set to on, a 
negative response X'1005 0112' is returned. 

Bits 1-14 Reserved (must be off). 
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Table 15-49 (Page 2 of 2). Structure of the 5250 QUERY STATION STATE Command 


Field Designation 


Value Function 


Bit 15 Indicates to return all customization states when set to logic 1. If set to 
off, only the Keystroke Buffering Control Minor Structure is returned. In 
addition to state information, bit 5 of byte 3 of the Keystroke Buffering 
Control Minor Structure is set to logic 1 to make sure the type ahead 
state is updated if the 5250 QUERY STATION STATE response data is 
used later in a 5250 WSC CUSTOMIZATION command. 


Table 15-50. Structure of the 5250 QUERY STATION STATE Response 


Field Designation 
LL (2 bytes) 

C (1 byte) 

T (1 byte) 

F1 (2 bytes) 

Data Field 


Value Function 

2X'0009' Total length of structured field and all minor structures. 
X'Dg' 5250 structured field command class. | 
X'72' Query station state command type. 

X'8000' Fixed code for a 5250 QUERY STATION STATE response. 


This field contains one or more customization minor structures, returned 
in the same format as specified for the 5250 WSC CUSTOMIZATION 
command. See “5250 WSC CUSTOMIZATION Command” on 

page 15-118 for more information about the 5250 WSC 
CUSTOMIZATION command. 


Text Support Data Streams 


The text support function requires that the AS/400 system support DisplayWrite 
software. This software uses structured fields to control most aspects of 
workstation operation. The following sections describe the function of each 
structured field associated with the text support data stream. 


DEFINE AUDIT WINDOW TABLE Command | | 

The DEFINE AUDIT WINDOW TABLE command determines the contents of audit 
window messages and the character associated with each message. When a 
workstation cursor is positioned under one of these characters, the 5494 transmits 
the appropriate message to the audit window of that workstation. Because the 
5494 maintains only one audit window table, changing a table entry affects all 
displays. 


Note: The 5494 actually maintains two tables, one for the primary language and 
one for the secondary language. These tables contain the same information but in 
different languages. 


Table 15-51 shows the structure of this command and defines the function of each 
field. 


Table 15-51 (Page 171 of 2). Structure of the DEFINE AUDIT WINDOW TABLE Command 


Field Designation 
LL (2 bytes) 


C (1 byte) 
T (1 byte) 


Value Function 

X'0005' to Total length of structured field. 

X'0204' 

X'DY' 5250 structured field command class. 
X'30! _ Type code for audit window parameters. 
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Table 15-51 (Page 2 of 2). Structure of the DEFINE AUDIT WINDOW TABLE Command 


Field Designation 
ID (1 byte) 


Table Entries 


L (1 byte) 


Character (1 byte) 


Message (0 to 20 bytes) 


Value Function 

X'00' to Indicates if update of primary audit window table is necessary. If this 

X'7F! byte matches the ID of the existing primary audit window table, the rest 
of this command is discarded. 

X'80' to Indicates if update of secondary audit window table is necessary. If this 

X'FE' byte matches the ID of the existing secondary audit window table, the 
rest of this command is discarded. 

X'FF' Indicates the value of the ID bytes set by the 5494 when the table is 


built initially. If an ID value of X'FF' is received, both the primary and 
secondary tables are initially emptied. Updates occur only if this byte 
does not match the existing audit window table ID. 


Each table entry consists of a 1-byte L-field, a 1-byte character code, 
and up to 20 bytes of message text. These entries determine the 
characters and messages that appear in the audit window on the 
workstation screen. 


X'02' to Total length of single table entry. 

X'16' 
This field defines a single character to be entered in AUDIT WINDOW 
TABLE. 


This field contains the text to be displayed in audit window. 


DEFINE COMMAND KEY FUNCTION Command 

The DEFINE COMMAND KEY FUNCTION command assigns specific functions to 
the Home key, the Del key, and the top row of command keys on the workstation 
keyboard. The 5494 uses this command to build a table in which key codes are 
associated with one of seven functions. Because the 5494 maintains only a single 
command key function table, changing a table entry affects all attached 
workstations. 


Note: The 5494 actually maintains two tables, one for the primary language and 
one for the secondary language. These tables contain the same information but in 
different languages. 


Table 15-52 shows the structure of this command and defines the function of each 
field. 


Table 15-52 (Page 1 of 2). Structure of the DEFINE COMMAND KEY FUNCTION Command 


Field Designation — 
LL (2 bytes) 


C (1 byte) 
T (1 byte) 


Value Function 

X'0005' to Total length of structured field. 

X'0184' 

X'D9Y' 5250 structured field command class. 
X'31' Type code for Command key function data. 
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Table 15-52 (Page 2 of 2). Structure of the DEFINE COMMAND KEY FUNCTION Command 


Field Designation Value 


ID (1 byte) X'00' to 
X'7F! 


X'80' to 
X'FE! 


X'FF! 


Table Entries. 


L (1 byte) a X'03' to 
X'52! 


Key Code (1 byte) 


Function Code (1 byte) 


Prompt Text (0-79 bytes) 


Function 


Indicates if update of primary command key function table is necessary. 
If this byte matches the ID of the existing primary command key function 
table, the rest of this command is discarded. 


Indicates if update of secondary command key function table is 
necessary. If this byte matches the ID of the existing secondary 
command key function table, the rest of this command is discarded. 


Indicates the value of the ID bytes set by the 5494 when the table is 
built initially. If an ID value of X'FF' is received, both the primary and 
secondary tables are initially emptied. Updates occur only if this byte 
does not match the existing command key function table ID. 


Each table entry defines the function of a single Command key. 


Total length of a single table entry. 


Supplies the ID code for the Command key whose function is being set. 
Key codes are: 


e X'01' to X'18'—Command key number 
X'FB'—Symbols Support (Cmd + A) message 
X'FC'—Formatted text usage 

X'FD'—Stop code advance key 

X'FE'—Del key 

X'FF'—Home key 


Assigns a specific function to the selected command as: 


¢ X'01'—Perform general prompt 

X'02'—Perform locate 

X'03'—Perform copy text 

X'04'—Perform move text 

X'05'—Perform delete text 

X'06'—Perform hyphenate text 

¢ X'07'-Display AS/400 system-defined prompt line message 


Message text to be displayed on prompt line. 


READ TEXT SCREEN Command 

The AS/400 system uses the READ TEXT SCREEN command to initiate transfer of 
text data from a workstation during WP mode operation. When the 5494 receives 
this command, it ordinarily remains pending until the operator presses an 
AlD-generating key. However, if the Continuous Insert mode is active at the 
workstation, the 5494 generates the AID request internally. Table 15-53 and 
Table 15-54 on page 15-143 show the general structure of READ TEXT SCREEN 
commands and responses. Table 15-55 on page 15-143 shows the internal 
structure of the READ TEXT SCREEN response data field. 


Table 15-53 (Page 1 of 2). Structure of the READ TEXT SCREEN Command 


Field Designation Value 
LL (2 bytes) X'0008 ' 
C (1 byte) X'D9g' 
T (1 byte) X'32' 
P (1 byte) X'00' 


15-142 Functions Reference 


Function 

Total length of structured field. 

5250 structured field command class. 
Type code for read text screen data. 


Partition code. 


Table 15-53 (Page 2 of 2). Structure of the READ TEXT SCREEN Command 


Field Designation Value 
F1 (1 byte) X'80! 
FF (2 bytes) X'0000' 


Function 
This flag indicates that: 


e The data field is in IBM 5250 line format. 

e The structured field command form is used. 

¢ Command pending format is used. 

e No pending data is included with the command. 


Null flags bits are required. 


Table 15-54. Structure of the READ TEXT SCREEN Response 


Field Designation Value 
Cursor Position (2 bytes) X'rrec' 

AID (1 byte) 

LL (2 bytes) =X'000C ' 

C (1 byte) X'D9' 

T (1 byte) X'32' 

P (1 byte) X'00' 

Fi (1 byte) B'110z0000' 
FF (2 bytes) X'0000' 


Home Position (4 bytes) 


Line Data 


Function 

Identifies the cursor row (rr) and column (cc). 
Identifies AID that satisfied READ. 

Total length of structured field. 

5250 structured field command class. — 

Type code for read text screen data. 
Partition code. 


This flag indicates that the read data is contained in a structured field 
and presented in IBM 5250 line format. The value of z (bit 3) is set to 
logic 1 when pending data is included after the line data field. 


Null flag required. 
This field contains the row and column address for the home position. 


This field contains modified line data read from the screen. See 
Table 15-55 for field definitions. 


Table 15-55 (Page 1 of 2). Structure of the READ TEXT SCREEN Response Line Data 


Field Designation Function 
L (1 or 2 bytes) Indicates the length of the line data field. It is 2 bytes for all displays with 


extended attribute ability and 1 byte for all others and includes the length 
byte or bytes. | 


FF (2 bytes) Contains the same flag bits as F1 and F2 of the WRITE TEXT SCREEN 
command line data. | 


Row (2 bytes) Identifies the physical row where this line of data is located. Its value is 
from X'01' to the screen height. 

F3 (1 byte) Contains the same flag bits as F3 of the WRITE TEXT SCREEN command 
line data. 

Page Number (2 bytes) Identifies the document page number that contains this line of data. 

Line ID (3 bytes) Identifies this line of data to the AS/400 system. 

Left Margin Offset (1 byte) Indicates the effective left margin of this line of data. Its value is from X'00' 
to X'nn', where nn = right margin — left margin — 1. 

Indent Offset (1 byte) Contains the same value as the indent offset parameter in the WRITE TEXT 


SCREEN command. Its value is from X'00' to X'nn', where nn = right 
margin — left margin — left margin offset — 1. 


Scale Line ID (1 byte) | Identifies the scale line associated with this line of data. 
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Table 15-55 (Page 2 of 2). Structure of the READ TEXT SCREEN Response Line Data 


Field Designation 


Line Image 


Function 


Data on screen at a specified row. This field may also contain control data. 


DEFINE PENDING OPERATIONS Command 

The AS/400 system uses the DEFINE PENDING OPERATIONS command to 
transmit information about the operating state to the 5494 for a specific workstation. 
Table 15-56 shows the structure of this command and defines the function of each 


field. 


Table 15-56. Structure of the DEFINE PENDING OPERATIONS Command 


Field Designation Value 

LL (2 bytes) | X'0007' or 
X'OO0E' 

C (1 byte) X'Dg' 

T (1 byte) X'33! 

P (1 byte) X'00! 

F1 (1 byte) 

F2 (1 byte) X'00' | 
X'80' 


Displaced Characters 
(3 bytes) 


Start Location (4 bytes) 


Function 


Total length of structured field. 


5250 structured field command class. 
Type code for pending operations data. 
Partition code. 


The bits in this field control the following WP mode functions: 


Bit O Enables the Insert mode when this bit is set to logic 1. 
Bit 1 Enables the Locate mode when this bit is set to logic 1. 
Bit 2 Determines whether the 5494 or the AS/400 system controls 


the text delete function. When this bit is set to logic 1, the 
AS/400 system controls text delete. 

Bit3 Determines how the 5494 responds to the Error Reset key. 
If this bit is set to logic 1, the 5494 responds by locking the 
workstation keyboard and sending an X'4E' AID request to 
the AS/400 system. | 

Bit 4 Determines if the 5494 notifies the AS/400 system on 
completion of a copy, move, or delete operation. When this 
bit is set to logic 1, host notification is required. 


Bit 5 Enables AS/400 system assisted locate function when this 
bit is set to logic 1. 

Bit 6 Enables tab function independent of shift status when this bit 
is set to logic 1. 

Bit 7 O = Insert mode is reset by Error Reset key. 


1 = Insert mode is toggled by the Insert key. 


Copy, move, or delete is not pending. 
Copy, move, or delete is pending. 


Contains codes for any character that was displaced during a copy, 
move, or delete operation. 


Contains the row and column address for the starting position for a 
copy, move, or delete operation. 


DEFINE TEXT SCREEN FORMAT Command 

The AS/400 system uses the DEFINE TEXT SCREEN FORMAT command to clear 
any outstanding error conditions and place a workstation in the WP mode. This 
command must precede all other WP commands. Table 15-57 on page 15-145 
shows the structure of this command and defines the function of each field. 


15-144 — Functions Reference 


Table 15-57 (Page 1 of 2). Structure of the DEFINE TEXT SCREEN FORMAT Command 


Field Designation 
LL (2 bytes) 


C (1 byte) 
T (1 byte) 


P (1 byte) 
F1 (1 byte) 


F2 (1 byte) 


Text Body Height 
(2 bytes) 


Value 
X'0007' 
X'OO09' 
X'OOOB' 
X'OO0C' 
X'OOOD' 
X'OOOE ' 
X'DY' 
X'34!' 


X'00' 


Function 


Total length of structured field. 


5250 structured field command class. 


Type code for a WP screen. This code causes the 5494 to enter WP 
mode operation. 


Null partition code required. 


Indicates the current status of text screen functions as: 


Bit 0 0 = Column edit is not active 
1 = Column edit active 
Bit 1 0 = No data outside left margin 
1 = Data exists outside left margin 
Bit 2 0 = No data outside right margin 
1 = Data exists outside right margin 
Bit 3 0 = No cursor-sensitive scrolling active 
1 = Cursor-sensitive scrolling active 
Bit 4 0 = No fake DP mode active 
1 = Fake DP mode active 
Bit 5 0 = Clear screen as normal 
1 = Do not clear screen 
Bit 6 0 = Document orientation is left to right 
1 = Document orientation is right to left 
Bit 7 0 = Host has bi-directional (BID!) support 


1 = Host does not have BIDI support. 


Supplies information about the AS/400 system as: 


Bit 0 0 = Data stream from $/36 system. 
1 = Data stream from AS/400 system. 
Bit 1 0 = The screen data in READ and WRITE commands does 


not have extended attributes. 
1 = The screen data does have extended attributes. 


Bit 2 0 = OfficeVision/400 edit session 
1 = WordPerfect/400 edit session 
Bit 3 0 = Primary language tables should be used. 


1 = Secondary language tables should be used. 
Bits 4-7 AS/400 system release level. 
e B'0000'-B'0111'Reserved 

B'1000'—AS/400 System Version 2 Release 2.0 
B'1001 '—AS/400 System Version 2 Release 3.0 
B'1010'—AS/400 System Version 3 Release 0.5 
B'1011'-AS/400 System Version 3 Release 1.0 
B'1100'—-B'1111' Reserved. 


Indicates the number of rows in the body of the text. Its value is from 
X'0005' to X'nnnn', where nnnn=screen height - row containing the 
first line of text. 
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Table 15-57 (Page 2 of 2). Structure of the DEFINE TEXT SCREEN FORMAT Command 


Field Designation Value 
Text Body Width 

(2 bytes) 

or 

Status Line Row 

(1 byte) 

Scale Line Row 


(1 byte) 


Line Cmd Field Size 
(1 byte) 


Location of Pitch 
(1 byte) 


First Line in Text Body 
(1 byte) 


Function 


AS/400 Releases before Version 2 Release 3.0: Indicates the width of 
text body in columns. These bytes are ignored by the 5494. 


AS/400 Release Version 2 Release 3.0 and higher: Indicates the row 
to be used for display of the status line and scale line. If either is set to 
X'00', this line is not displayed. 


Note: The WordPerfect for the AS/400 editor always sets these bytes 
to X'00'. 


Indicates the number of column positions in LINE command fields. Its 
value is from X'00' to X'nn', where nn=screen width - X'05'. 


Indicates the location of the pitch indicator on the status line. Its value 
is from X'01' to X'nn', where nn=screen width — X'05'. 


Indicates the row number of the first line in the text body. 


DEFINE SCALE LINE Command 

The AS/400 system uses the DEFINE SCALE LINE command to control the scale 
lines of attached workstations. Each time the 5494 receives this command, it 
clears all scale lines for the specified workstation. As a result, defining a single 
scale line requires redefining all scale lines for that workstation. Table 15-58 
shows the structure of this command and defines the function of each field. 


Table 15-58 (Page 1 of 2). Structure of the DEFINE SCALE LINE Command 


Field Designation Value 

LL (1 byte) X'0008' to 
X'0197' 

C (1 byte) X'D9Q' 

T (1 byte) X'35' 

P (1 byte) X'00' 

F1 (1 byte) X'00' 


RTL Offset (1 byte) 


Offset (1 byte) 


Scale Lines 


L (1 byte) >X'02'! 


15-146 — Functions Reference 


Function 


Total length of structured field including length byte. 


5250 structured field command class. 
Type code for scale line parameters. 
Null partition code required. 

Null flag required. 


Indicates the offset applied to a right-to-left scale line for displaying on 
the screen. Its value is X'nn', where nn=X'0100' - screen width. This 
offset is used only by a BIDI AS/400 system. A BIDI AS/400 system 
sends this byte to the 5494 only if the 5494 is running the text-assist 
function. Refer to /BM 5494 Remote Control Unit National Language 
Support for Arabic or IBM 5494 Remote Control Unit National Language 
Support for Hebrew. 


Indicates the offset applied to the scale line for display on the screen. 
Its value is from X'00' to X'nn', where nn=X'100' - screen width + 
LINE command field width + 1. 


This field contains parameters for each scale line defined for the current 
WP task. | 


Indicates the length of a single scale line definition including length byte. 


Table 15-58 (Page 2 of 2). Structure of the DEFINE SCALE LINE Command 


Field Designation 
F (1 byte) 


ID (1 byte) 
Location (1 byte) 


Function (1 byte) 


Value 


Function 
Controls scale line symbols as: 


Bit O When this bit is set to logic 1, it suppresses display of the right 
margin symbol. 

Bit 1 When this bit is set to logic 1, it suppresses display of the left 
margin symbol. 

Bit 2 When this bit is set to logic 1, it causes the indication of a tab 
stop located off the display if the absolute right margin is not 
defined. 

Bits 3-7 Reserved. 


Supplies an identification code for each scale line defined. 


Identifies the column location of the special character listed in the 
function field. 


Contains the code for the special character in the column position 
designated in the location field. The location and function fields can be 
repeated as often as required. The following values print the 
corresponding characters: 


X'01' Left margin symbol 
X'02' Right margin symbol 
X'03' Left tab symbol 

X'04' Right tab symbol 

X'05' Center tab symbol 
X'06' Decimal align tab symbol 
X'07' Comma align tab symbol 
X'08' Colon align tab symbol 
X'09' Inactive tab stop symbol 
X'OA' Center of margins symbol 
X'0OB' Paper edge symbol 
X'OC' Pitch symbol 
X'OD'—X'FF' Reserved. 


WRITE TEXT SCREEN Command 

The AS/400 system uses the WRITE TEXT SCREEN command to write data to a 
workstation during WP mode operation. Because the 5494 passes the data stream 
to the designated workstation without modification, the AS/400 system must supply 
all formatting parameters. Table 15-59 shows command structure and defines the 
function of each field. Table 15-60 on page 15-148 shows the structure of the line 


data field. 


Table 15-59 (Page 1 of 2). Structure of the WRITE TEXT SCREEN Command 


Field Designation 
LL (2 bytes) 

C (1 byte) 

T (1 byte) 

P (1 byte) 


Value 
=X'0008 ' 
X'D9' 
X'36' 
X'00' 


- Function 


Total length of structured field. 
5250 structured field command class. 
Type code for write text screen data. 


Null partition code required. 
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Table 15-59 (Page 2 of 2). Structure of the WRITE TEXT SCREEN Command 


Field Designation Value 
F1 (1 byte) 


F2 (1 byte) X'20! 


F3 (1 byte) 


Home Position X'rrrreccc' 
(4 bytes) 


Line Data 


Function 


Controls processing of command parameters as: 


Bit O 0 = 3270 format (not supported on 5494). 


1 = 5250 format. 
Bit 1 0 = First line in body is an even number of half-spacing units. 
1 = First line in body is an odd number of half-spacing units. 
Bit 2 0 = Cursor is not on a line that contains formatted text. No 
function is performed. : 
1 = Cursor is on a line of formatted text. The 5494 displays 
text message defined in the Define Command Key table. 
Bit 3 0 = Do not display the primary attribute 
1 = Display the primary attribute at the cursor location. 
Bits 4—7 Reserved. 


Control flag locks keyboard to inhibit data input before any lines are 
written to screen. 


Determines display station actions after write operation is completed as: 


Bit O Reserved. 

Bit 1 Moves cursor to home position when this bit is set to logic 1. It 
suppresses the function when set to logic 0. 

Bit 2 Resets Cursor Blinking mode when this bit is set to logic 1. It 
suppresses the function when set to logic 0. 

Bit3 Sets Cursor Blinking mode when this bit is set to logic 1. It 
suppresses the function when set to logic 0. 

Bit 4 Resets keyboard locking function when this bit is set to logic 1. 
It suppresses the function when set to logic 0. 

Bit5 | Enables audible alarm when this bit is set to logic 1. It 
suppresses the function when set to logic 0. 

Bit 6 Resets Message Waiting indicator when this bit is set to logic 
1. It suppresses the function when set to logic 0. 

Bit 7 Sets Message Waiting indicator when this bit is set to logic 1. 
It suppresses the function when set to logic 0. 


Contains the row (rrrr) and column (cccc) addresses of the home 
position. 


This field contains the actual contents to be written to designated fields 
of the display screen. See Table 15-60 for detailed field definitions. 


Table 15-60 (Page 17 of 3). Structure of the WRITE TEXT SCREEN Command Line Data 


Field Designation Value 


Line Data 


L (1 or 2 byte) 


15-148 — Functions Reference 


Function 


This field contains the actual contents to be written to designated lines 
of the display screen. 


Total length of line data field. Two length bytes are sent with this 
command if bit 1 of byte F2 in the DEFINE TEXT SCREEN FORMAT 
command (Table 15-57 on page 15-145) was set to 1 when the text 
screen was defined. 


Table 15-60 (Page 2 of 3). Structure of the WRITE TEXT SCREEN Command Line Data 


Field Designation 
F1 (1 byte) 


F2 (1 byte) 


Row (2 bytes) 
F3 (1 byte) 


Page Number (2 bytes) 
Line ID (8 bytes) 


Left Margin Offset (1 
byte) 


Value 


Function 
Includes the following control flags: 


BitO Writes nulls to the line before writing data when this bit is set to 


logic 1. 

Bit 1 Inhibits changes to text on this line when this bit is set to 
logic 1. 

Bit 2 Inhibits all input functions on this line when this bit is set to 
logic 1. | 


Bit 3 Indicates that this line has been modified by the operator when 
this bit is set to logic 1. 
Bit 4 Indicates that the text body has been modified when this bit is 


set to logic 1. 

Bit 5 Inhibits the word spill function on this line when this bit is set to 
logic 1. 

Bit 6 Spills the last word on this line to the next line when this bit is 
set to logic 1. 


Bit 7 Not used. 
Includes the following control flags: 


Bit O Indicates that this row contains formatted text when this bit is 
set to logic 1. 

Bit 1 Indicates that a required tab character exists left of absolute left 
margin when this bit is set to logic 1. 

Bit 2 Indicates that a tab character exists left of absolute left margin 
when this bit is set to logic 1. 

Bit 3 Indicates that a required tab character exists right of absolute 
right margin when this bit is set to logic 1. 

Bit 4 Indicates that a tab character exists right of absolute right 
margin when this bit is set to logic 1. | 

Bits 5-7 Define line spacing in half-spacing units. The maximum value 
of this parameter is B'111'. 


Indicates the physical row where the line of data is located. 
Includes the following flags: 


Bit 0 Indicates that line orientation is right to left when this bit is set 
to logic 1. 

Bit 1 Indicates that ‘begin reverse’ exists to the left of left margin 
when this bit is set to logic 1. 

Bit 2 Indicates that ‘end reverse’ exists to the right of right margin 

_ when set to logic 1. 

Bit 3 Reserved. 

Bit 4 Indicates that a primary attribute exists on the line when set to 
logic 1. 

Bit 5 Indicates that an end attribute exists one position to the right of 
right margin if set to logic 1. _ 

Bit 6 Indicates that one or more word underscore control characters 
(X'1D') exist on the line if set to logic 1. 

Bit 7 Indicates that one or more half index up or half index down text 
attributes exist on the line if set to logic 1. 


Reserved. - 
Identifies this line of data to the AS/400 system. 


Determines the actual text margin. Its value is from X'00' to X'nn', 
where nn = right margin — left margin — 1. 
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Table 15-60 (Page 3 of 3). Structure of the WRITE TEXT SCREEN Command Line Data 


Field Designation Value 
Indent Offset (1 byte) 


Scale Line ID (1 byte) 


Line Image 


Function 


Indicates the amount of text indentation caused by required characters 
to the left of the margin. Its value is from X'00' to X'nn', where nn = 
right margin — left margin — left margin offset — 1. 


Identifies the scale line associated with this line of data. 


This field contains 1 byte for each character to be written to the screen. 
If control characters are intermixed with data, this field can be longer 
than the screen width. 


DEFINE SPECIAL CHARACTERS Command 

The AS/400 system uses the DEFINE SPECIAL CHARACTERS command to 
establish an EBCDIC value for a Required Carrier Return character. Table 15-61 
shows the command structure and defines the function of each field. 


Table 15-61. Structure of the DEFINE SPECIAL CHARACTERS Command 


Field Designation Value 

LL (2 bytes) ~ X'0007' or 
X'0009' 

C (1 byte) X'D9' 

T (1 byte) X'37' 

P (1 byte) X'00! 

FF (2 bytes) X'0000' 


Symbol Key (1 byte) 


EBCDIC Value (1 byte) X'06', 


X'1F', ore 


X'40' 


Function 


Total length of structured field. 


5250 structured field command class. 
Type code for special character data. 
Null partition code required. 

Null flag required. 


This field contains a value that is paired with an EBCDIC value for the 
special character to be displayed. The value of X'01' corresponds to 
the Required Carrier Return symbol. 


This field contains the 1-byte EBCDIC value to be displayed. 


PENDING DATA Response 

When the AS/400 system transmits a READ TEXT SCREEN command, the 5494 
returns the screen data in a READ TEXT SCREEN response. If bit 3 of the F1 
byte in the response is on (logic 1), the response data stream also includes 
pending data information. Table 15-62 shows the format of this data structure and 
defines the function of each field. | 


Table 15-62 (Page 71 of 2). Structure of the PENDING DATA Response 


Field Designation Value 
LL (2 bytes) X'0010! 
C (1 byte) X'D9' 
T (1 byte) X'38' 
P (1 byte) X'00' 


15-150 — Functions Reference 


Function 

Total length of pending data message. 
5250 structured field command class. 
Type code for pending data. 


Null partition code required. 


Table 15-62 (Page 2 of 2). Structure of the PENDING DATA Response 


Field Designation Value Function 
F1 (1 byte) This byte contains the following status flags: 
Bit 0 Indicates that Insert mode is on when this bit is set to 
logic 1. 
Bit 1 Indicates that Locate mode is on when this bit is set to 
logic 1. 


Bits 2-3 —_ Indicate current status of delete text operations. Bit 2 is set 
to logic 1 when an active operation is completed if the 
AS/400 system previously requested notification. Bit 3 is set 
to logic 1 when an active operation is canceled by the 
operator and the AS/400 system previously requested 


notification. 

Bit 4 Indicates that a delete text operation is currently in progress 
when this bit is set to logic 1. 

Bit 5 Indicates that a copy text operation is currently in progress 
when this bit is set to logic 1. 

Bit 6 Indicates that a move text operation is currently in progress 
when this bit is set to logic 1. 

Bit 7 Indicates that a general prompt is currently active when this 
bit is set to logic 1. 

F2 (1 byte) This byte contains the following status flags: 

Bit O Indicates that the + character is used to display half-line 
spacing for this 5291 display when set to logic 1. 

Bit 1 Indicates a primary attribute was displayed at the cursor 
location when set to logic 1. 

Bit 2 Indicates a text attribute was displayed at the cursor location 
when set to logic 1. 

Bit 3 Indicates a primary attribute was displayed at the copy, 
move, or delete start position when set to logic 1. 

Bit 4 Indicates a text attribute was displayed at the copy, move, or 


delete start position when set to logic 1. 
Bits 5-7 Reserved. 


Displaced Characters (3 Contains codes for any character that was displaced by attributes during 

bytes) a copy, move, or delete operation. 

Start Location (4 bytes) Identifies the row and column where a copy, move, or delete operation 
starts. 

Locate Character (1 byte) Contains the code for the character to be located during a AS/400 


system-assisted locate operation. 


AID (1 byte) Contains the AID code corresponding to the key that invoked a general 
prompt operation. 


DEFINE OPERATOR ERROR MESSAGES Command 

The AS/400 system uses the DEFINE OPERATOR ERROR MESSAGES command 
to download error messages to two message tables in the 5494 for messages in 
two languages. Table 15-63 on page 15-152 shows the structure of this command 
and defines the function of each field. 
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Table 15-63. Structure of the DEFINE OPERATOR ERROR MESSAGES Command 


Field Designation 
LL (2 bytes) 


C (1 byte) 
T (1 byte) 
ID (1 byte) 


Table Entries 
L (1 byte) 


Error Code (2 bytes) 


Message Text 


Value 


X'0005' to 


X'0304' 
X'D9' 
X'39'! 


X'00' to 
X'7F' 


X'80' to 
X'FE' 


X' FF! 


X'03' to 
X'53' 


Function 


Total length of structured field. 


5250 structured field command class. 
Type code for error message data. 


Indicates if update of primary operator error message table is necessary. 
If this byte matches the ID of the existing primary operator error 
message table, the rest of this command is discarded. 


Indicates if update of secondary operator error message table is 
necessary. If this byte matches the ID of the existing secondary 
operator error message table, the rest of this command is discarded. 


Indicates the value of the ID bytes set by the 5494 when the table is 
built initially. If an ID value of X'FF' is received, both the primary and 
secondary tables are initially emptied. Updates occur only if this byte 
does not match the existing operator error message table ID. 


Each table entry defines a single error message. 


Total length of entry. 


Contains the code associated with this message. 


Contains up to 80 bytes of text to be displayed on the error line when 
this error is detected. 


DEFINE PITCH TABLE Command 
The AS/400 system uses the DEFINE PITCH TABLE command to control the value 
that appears in the pitch field of the command line. The 5494 allows two pitch 

_ tables for messages in two languages. Table 15-64 shows the structure of this 
command and defines the function of each field. 


Table 15-64. Structure of the DEFINE PITCH TABLE Command 


Field Designation 
LL (2 bytes) 


C (1 byte) 
T (1 byte) 
ID (1 byte) 


Table Entries 


Value 


X'0005' to 


X'0055' 
X'D9g' 
X'3A' 


X'00' to 
X'7F 


X'80' to 
X'FE' 


X'FF' 


15-152 Functions Reference 


Function 


Total length of structured field. 


5250 structured field command class. 
Type code for pitch table parameters. 


Indicates if update of primary pitch table is necessary. If this byte 
matches the ID of the existing primary pitch table, the rest of this 
command is discarded. 


Indicates if update of secondary pitch table is necessary. If this byte 
matches the ID of the existing secondary pitch table, the rest of this 
command is discarded. 


Indicates the value of the ID bytes set by the 5494 when the table is 
built initially. If an ID value of X'FF' is received, both the primary and 
secondary tables are initially emptied. Updates occur only if this byte 
does not match the existing operator error message table ID. 


Each table entry consists of a 1-byte L-field and a 4-byte EBCDIC code 
for the value of text pitch that is displayed on the status line. 


DEFINE FAKE DP COMMAND KEY FUNCTION Command 

The AS/400 system uses this command to determine how the 5494 responds to 
inputs from command keys when the workstation is in the Fake DP mode. The 
command includes two different data structures. The first of these (F = X'01') 
defines the function of core area command keys. The second (F = X'02') defines 
the function of the top row command keys. Table 15-65 shows the structure of this 
command, and Table 15-66 shows the structure of the data field. 


Table 15-65. Structure of the DEFINE FAKE DP COMMAND KEY FUNCTION Command 


Field Designation Value 

LL (2 bytes) 2X'0007' 
C (1 byte) X'D9g' 

T (1 byte) X'3B' 

P (1 byte) X'00! 
FF (2 bytes) X'0000' 
Data Field 


Function 

Total length of structured field. 

5250 structured field command class. 

Type code for Fake DP command definitions. 
Null partition code required. 

Null flags required. 


This field defines the functions performed by command keys while the 
workstation is operating in the Fake DP mode. 


Table 15-66. Structure of the DEFINE FAKE DP COMMAND KEY FUNCTION Core Area Command Keys 


Field Designation Value 
L (1 byte) X'04' 
F (1 byte) X'80! 


Data Field (2 bytes) 


Function | 

Total length of core area Command key definitions. 

Indicates that the data field defines core area Command key functions. 
Controls core area Command key functions as: 


BitO | When this bit is set to logic 1, typing Cmd u (begin underscore) 
causes the operator error '77'. 

Bit 1 When this bit is set to logic 1, typing Cmd j (end attribute) 
causes the operator error '77'. 

Bit2 When this bit is set to logic 1, typing Cmd b (begin bold) 
causes the operator error '77'. 

Bit3 When this bit is set to logic 1, typing Cmd w (word underscore) 
causes the operator error '77'. 

Bit 4 When this bit is set to logic 1, typing Cmd y (half-index-up) 
causes the operator error '77'. 

Bit 5 When this bit is set to logic 1, typing Cmd h (half-index-down) 
causes the operator error '77'. | 

Bit 6 When this bit is set to logic 1, typing Cmd s (stop code) causes 
the operator error '77'. 

Bit 7 When this bit is set to logic 1, typing Cmd space (required 
space) causes the operator error '77'. 
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Table 15-67. Structure of the DEFINE FAKE DP COMMAND KEY FUNCTION Top Row Command Keys 


Field Designation Value Function 

L (1 byte) X'06' Total length of top row Command key definitions. 

F (1 byte) X'40' Indicates that data field defines top row Command key functions. 

Data Field (4 bytes) Bit O through Bit 23 control the operation of the corresponding top row 


Command key. When one of these bits is set to logic 1, pressing that 
Command key causes the operator error '77'. Bits 24 through 31 are 
reserved. 


Reserved WRITE STRUCTURED FIELD Orders 
Suborders D8 20 and D8 21 of the WSF are reserved. 


COPY-TO-PRINTER Command 


The COPY-TO-PRINTER command causes the 5494 to copy a screen image from 
a workstation to a designated printer during customer setup (CSU), concurrent 
mode operation, or normal sessions with the AS/400 system. During normal 
sessions, the AS/400 system determines which printer the 5494 uses for output. 
During CSU or concurrent mode operation, the 5494 uses data from a special input 
field on the workstation screen to select a printer. The command code is X'16'. 


COPY-TO-PRINTER Printer Max lines per page 


Command LSID X'nn' 
x'16' X'nn' 





Printer LSID is computed using the formula: (port number x 7)+ station address. If 
the maximum lines per page parameter is X'00', then the 5494 sets the printer 
page length equal to the number of lines on the display screen. 


COPY-TO-PRINTER with AS/400 System Participation 


If an operator presses the Print key while the workstation is in session with the 
AS/400 system, the 5494 recognizes the keystroke and sends AID byte X'F6' to 
the AS/400 system. The AS/400 system then sends the COPY-TO-PRINTER 
command to the 5494 with the LSID and lines per page specified. If the specified 
printer is turned off, already in session (LU-LU), or the 5494 is configured for printer 
sharing, the 5494 returns the negative response X'08010200'. If the specified 
LSID is not a printer, then the 5494 sends negative response X'10050181'. If the 
LSID is not assigned, the 5494 sends X'10050180'. The AS/400 system must 
send this command LIC or OIC. 


The operator can cancel the copy operation by pressing the Cancel key. The 5494 
cancels the operation and sends negative response X'08110200' (X'08110201' if 
the printer is in error state). 


The 5494 uses negative responses rather than the SNA SIGNAL, which is normally 
used to report printer errors to the AS/400 system. 


If the 5494 receives an ACTLU for a printer that is performing a 
COPY-TO-PRINTER, it then sends a response indicating that the printer is 
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unavailable, followed by LUSTAT X'00010000' when the printer becomes 
available. The 5494 sends negative response X'08010000' to a BIND for a busy 
printer, again followed by LUSTAT X'00010000' when the printer is available. 


When the copy operation is complete, the 5494 sends a response to the AS/400 
system indicating completion. The AS/400 system then returns the workstation to 
the state it was in before the Print key was pressed. The AS/400 system is 
responsible for error messages and unlocking the keyboard in the event of 

_ hardware errors during the copy. 


COPY-TO-PRINTER without AS/400 System Participation 


The 5494 can generate the COPY-TO-PRINTER command internally if no 
AS/400-to-5494 session is active. This capability allows the operator to copy the _ 
CSU screen without the participation of the AS/400 system. The LSID for the 
printer is supplied from a field on the CSU screen, and X'00' is written in the 
maximum lines per page byte of the COPY-TO-PRINTER command. If no printer 
was selected during CSU, the 5494 attempts to locate a printer that is ready to run 
a print operation. If this attempt fails, the 5494 posts X'520000' to the workstation 
(X'520001' if the selected LSID is not a printer). The 5494 cancels the print 
operation and posts X'520002' to the workstation if: 


e The printer is in a hardware error state when the operator presses the Print 
key. 


e The printer is turned off or in session with the AS/400 system when the 
operator presses the Print key. 


e The printer is not ready. 


The 5494 cancels the print operation and posts X'520003' to the workstation if the 
operator presses the Cancel key or turns off the printer during the print operation. 


The keyboard remains locked during the entire copy operation. If an error occurs, 
the operator must press the Reset key to continue. This causes the 5494 to clear 
the error code and unlock the keyboard. 


Continued Processing 


Whether the COPY-TO-PRINTER command is received from the AS/400 system or 
generated internally, the 5494 manages the entire exchange of information from 
display to printer. After sending the appropriate printer setup commands, the 5494 
reads data from the display screen and directs the printer line by line. See 
Chapter 18, “Printer Data Streams,” for a complete description of the printer data 
streams sent to each type of printer. Refer to the /BM 5494 Remote Control Unit 
User’s Guide for all possible error codes and negative responses. 
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Chapter 16. Keyboard Functions 


This chapter discusses keyboard states and describes key functions. 


States and Modes 


The workstation can be in one of several states (conditions) with their 
accompanying modes (methods of operation). An explanation of each follows this 
list. 


Hardware error 
Normal locked 
Normal unlocked 
Power-on | 
Pre-help error 
Post-help error 
SS message 

e System request. 


Hardware Error State 


The keyboard enters the hardware error state when a malfunction in the physical 
machine is detected. The characteristic of this state is that no keystrokes are 
processed. When the error is cleared, the keyboard enters the normal unlocked 
state (format level O selected). 


Normal Locked State 
The keyboard enters normal locked state when the workstation operator presses a 
key that requires AS/400 system attention or when the AS/400 system issues a 
command that locks the keyboard. These are the valid commands the AS/400 
system can use to put the workstation into this state: 


e CLEAR UNIT 

e CLEAR UNIT ALTERNATE 

e CLEAR FORMAT TABLE 

¢ WRITE TO DISPLAY (if the format table is altered) 

e RESTORE SCREEN (if SAVE SCREEN was issued to a locked keyboard). 
The characteristics of the locked state are: 

e The keyboard is locked, the clicker is off, and the Input Inhibited indicator is on. 

e All keys except Sys Req, Attn, Print (Cancel), and the shift keys are ignored. 
Pressing the Sys Req key puts the workstation in the system request state. The 
operator can exit the normal locked state by: 


e Issuing an unlock control character in a AS/400 system command that will 
unlock the keyboard : 
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e Entering the SS message state 
¢ Issuing an ACTLU, DACTLU, BIND, or UNBIND command. 


Normal Unlocked State 
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The characteristics of the normal unlocked state are: 


e The keyboard is unlocked, the clicker is on, and the Input Inhibited indicator is 
off. 


¢ Keys that are not valid cause errors. 


The keyboard enters the normal unlocked state as follows: 


e The AS/400 system sends commands that contain control characters to unlock 
the keyboard. 


e« The workstation operator presses the Error Reset key after a keying error. 


e The workstation operator does one of the following reset operations when the 
Original operation is initiated during a normal unlocked state: 


Error reset following a WRITE ERROR CODE command 

— Error reset following a WRITE ERROR CODE TO WINDOW command 
— Error reset following a Sys Reg key activation 

— Error reset following an SS message 

— Error reset following a Cmd key activation. 


Three modes can be selected within the normal unlocked state: Command mode, 
Insert mode, and Data mode. | 


Command Mode 
Command mode only exists on keyboards that have a Cmd key. It is not needed 
on other keyboards. 


The workstation operator selects the Command mode by pressing the Cmd key, 
which allows selection of preprogrammed command function keys. This mode 
cannot be entered when the keyboard is in the system request, normal locked, or 
error state, or in the Insert mode. The workstation operator can exit from 
Command mode by pressing the Error Reset key or any of the top row function 
keys. 


Insert Mode 

The workstation operator selects the Insert mode by pressing the Insert key, which 
allows insertion of data or text into existing data or text. When the Insert mode is 
in effect, the Insert indicator is on. This mode cannot be entered if the keyboard is 
in the normal locked or error state, or in Command mode. The operator presses 
the Error Reset key to exit this mode. 


Replace Mode 

The workstation operator selects the Replace mode by keying, or the programmer 
selects it with a control character. During this mode, the workstation operator can 
do any of the normal keying functions; the keyboard clicker is on, the Input Inhibited 
indicator is off, and the keyboard is unlocked. 
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Power-On State 


The power-on state occurs between the time the 5494 receives electrical power 
and the time it enters another state such as the system request state. During this 
time, the 5494 is in a Free Key mode. Free keying cannot occur if the 5494 is not 
running. During Free Key mode, all functions that do not require the AS/400 
system, but can be performed under the control of the 5494, are allowed. The 
characteristics of this state are: 


e From row 1 and column 2 of the display to the end of the display is considered 
one alphanumeric field. 


e Cursor movement and shift keys are functional. 


e Alphanumeric characters are accepted, translated, and returned to the display. 
The cursor is updated to the next entry position. 


e Functions that the 5494 can handle without the AS/400 system are operational. 
These are functions such as delete, insert, clear, and display. 


e Errors result from pressing a function key that requires the AS/400 system. 


Pre-Help Error State 


The keyboard enters the pre-help error state when the display station operator 
makes a keying error. The workstation operator can also enter this error state by 
receiving the WRITE ERROR CODE or WRITE ERROR CODE TO WINDOW 
command. The characteristics of this error state are: 


e The keyboard is locked, the clicker is off, and the Input Inhibited indicator is on. 
e All keys except Attn, Help, Reset, and the Shift keys are ignored. 
e The error line is saved. 
e The system reference code (SRC) is posted. 
e The cursor blinks. 
The workstation operator can exit this state by pressing the Error Reset key. This 


returns the keyboard to its previous state. The workstation operator can also 
choose to press the Help key and enter the post-help error state. 


Post-Help Error State 


The workstation operator selects the post-help error state by pressing the Help key 
after an error has occurred. The characteristics of this error state are: 


e The keyboard is locked, the clicker is off, and the Input Inhibited indicator is on. 
e Only the Attn and Shift keys are operational. 

e The leading attribute on the error line is highlighted. 

e A signal is sent to the AS/400 system. 


SS Message State 
The keyboard enters the SS message state when the AS/400 system transmits a 
message (on the SS-LU flow) to the workstation screen. The characteristics of this 
State are: 


¢ The keyboard is locked, the clicker is off, and the Input Inhibited indicator is on. 
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e Keys that are not valid are ignored. 
¢ The error line is saved. 


The keyboard re-enters the previous state when the workstation operator presses 
the Error Reset key. 


System Request State 


The keyboard enters the system request state when the workstation operator 
presses the Sys Req key. The characteristics of the system request state are: 


e The keyboard is unlocked. 
e The error line is saved and filled with null characters. 
¢ Keys that are not valid cause an exit to the error state. 


If the system request state is entered from the normal unlocked state by using the 
Sys Req key, the keyboard re-enters the normal unlocked state when the 
workstation operator presses the Error Reset key. Otherwise, Input Inhibited 
remains on. 


Keys 
The basic types of keys on both typewriter and data entry keyboards are: 


¢ Alphanumeric keys (typewriter-like in nature; including letters, numbers, and 
special characters). 


e Numeric keys; these are used for typing numeric data only. 
¢ Special function keys: 


— Attention identifier (AID) generating 
— Cursor movement | 
— Field exit 
— Signal 
— Special control 
— Special host 
— Diacritic. 
Note: Some of these keys are combinations of keystrokes on some keyboards. 
Refer to your workstation operator’s guide. 


The following sections describe the special function keys. 


AlD-Generating Keys 
The AlD-generating keys generate AID codes, which are transmitted to the AS/400 
system in response to the LU-LU READ commands. Valid AID functions are: 


e Clear | 

e Enter/Record Advance (Enter/Rec Adv) 
e Help (from non-error state) 

e Roll Up and Roll Down 

e Print 


e Record backspace function 
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Note: Record backspace is not a key; it is a function performed by the 
workstation operator using the Home key when the cursor is at the home 


position. 


e Auto Enter 


e Program Access (PA) 1 through 3 (See “Program Access (PA) 1-3” on 


page 16-15) 


e Command function 1 through 24. 


Table 16-1 shows the AID keys and their associated codes for keyboards with 24 
PF/Cmd keys. These codes alert the AS/400 system that the 5494 requires some 
action. The AID keys are not operational when the keyboard is locked, or when the 
cursor is in an active, right-adjust field. When the keys are operational, they lock 
the keyboard. Depending on the key that is pressed, the AID code either goes 
immediately to the AS/400 system if a READ command is pending, or is kept 
pending until the 5494 receives a READ command. When this happens, the AID 
code is sent to the AS/400 system in the normal LU-LU flow. 


Table 16-1 (Page 1 of 2). AID Keys and Their Codes 


Key 

Clear 

Enter or Record Adv 
Help 

Roll Down 

Roll Up 

Roll Left 

Roll Right 

Print 

Record Backspace 
SLP Auto Enter 
Forward Edge Trigger Auto Enter 
PA‘ 

PA2 

PA3 

Cmd 01 

Cmd 02 

Cmd 03 

Cmd 04 

Cmd 05 

Cmd 06 

Cmd 07 

Cmd 08 

Cmd 09 

Cmd 10 

Cmd 11 


Code 


BD 
F1 
F3 
FA 
F5 
D9 
DA 
F6 
F8 
3F 
50 
6C 
6E 
6B 
31 
32 
33 
34 
35 
36 
37 
38 
39 
3A 
3B 
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Table 16-1 (Page 2 of 2). AlD Keys and Their Codes 


Key | | Code 
Cmd 12 | | 3C 
Cmd 13 | B1 
Cmd 14 | B2- 
Cmd 15 oe B3 
Cmd 16 | B4 
Cmd 17 B5 
Cmd 18 B6 
Cmd 19 B7 
Cmd 20 — BS 
Cmd 21 B9 
Cmd 22 BA 
Cmd 23 BB 
Cmd 24 BC 
Application Use 70-7F 
Clear Key | 


The session environment determines the results of the clear function as follows: 


e lf the LU is not involved in a session, the Clear key clears the entire display 
regeneration buffer (fills it with nulls and selects format level 0). 


e lf the LU is involved in a session, the Clear key issues the AID code X'BD', 
which requests that the AS/400 system issue a CLEAR UNIT command to the 
LU to clear the display. 


Enter/Rec Adv Key 
In the normal unlocked state, when the workstation operator presses the Enter/Rec 
Adv key: 


1. The 5494 checks for the completion of mandatory-fill, self-check, and 
right-adjust fields when in an active field. (An active field is one in which the 
workstation operator has begun entering data.) If the requirements of the field 
have not been satisfied, an error occurs. 


2. The 5494 locks the keyboard. 


3. If the master MDT bit is on, the 5494 checks for unentered mandatory enter 
fields, positions the cursor where there is such a field that is unentered, and 
posts an operator error. 
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4. Assuming there is a READ command and CD, the 5494 sends the cursor 
address, AID code, and data in the input fields to the AS/400 system. The 
5494 formats this data by: 


a. Setting the zones on signed numeric fields 


b. Sending the entire input field and changing nulls to blanks on the READ 
INPUT command 


c. Stripping trailing nulls from the fields and changing leading and embedded 
nulls to blanks for the READ MDT command 


d. Resequencing the field as specified by the FCW. 


When the AS/400 system unlocks the keyboard, the cursor moves to the address 
specified by the IC, to the first non-bypass field if no IC is specified, or to row 1, 
column 1, if neither of these is given. 


Help Key (from Non-Error State) ; 

lf the display is not in an operator-error state and the workstation operator presses 
the Help key, the workstation issues an X'F3' AID byte to the AS/400 system. If, 
however, the workstation operator presses the Help key after pressing the Cmd key 
or the Sys Reg key, an error results. 


Roll Up and Roll Down Keys 
(Page Down = Roll Up, and Page Up = Roll Down.) 


These keys send a request to the AS/400 system to roll the information on the 
display. Roll Up issues AID code X'F5', and Roll Down issues AID code X'F4'. 
The workstation operator must first press a Shift key, then press the appropriate 
Roll key. 


The following conditions cause errors: 


e Using a roll key after the Sys Req key 
e Using a roll key after the Cmd key 
e Using a roll key when the workstation is in Insert mode. 


Print Key 

The Print key informs the 5494 that the workstation operator wants to print the 
contents of the present display. See “COPY-TO-PRINTER Command?” on 
page 15-154 for more information. 


Record Backspace Function 

When the Home key is pressed with the cursor already at the home position, a 
record backspace is requested; the keyboard is locked and the AID code (X'F8') 
and cursor address are sent to the AS/400 system. The AS/400 system should 
respond by repeating the writing of the previous record to the display. 


Command Function Keys 1-24 

The command function keys are accessed by first pressing Cmd and then one of 
the 24 numeric keys across the top of the keyboard. The functions of these keys 
are user-defined. 
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Signal Keys 


When the workstation operator presses a command function key | in the 
normal- unlocked state, the 5494: 


1. Checks for the completion of mandatory-fill, self-check, and right-adjust fields 
when the workstation operator is keying in an active field. An active field is one 
in which the workstation operator has begun entering data. 


2. Locks the keyboard. 


3. Checks for unentered mandatory-enter fields, positions the cursor where there 
is such a field, and posts an operator error (if the master MDT bit is on). 


4. Sends the cursor address, AID code, and data in the input fields to the AS/400 
system (for a READ command and CD). The 5494 formats this data by: 


a. Setting the zones on signed numeric fields 


b. Sending the entire input field and changing nulls to blanks on the READ 
INPUT command 


c. Stripping trailing nulls from the fields and changing leading and embedded 
nulls to blanks for the Read MDT command 


d. Resequencing the field as specified by the FCW. 


When the AS/400 system unlocks the keyboard, the cursor moves to the address 
specified by the IC, to the first non-bypass field, or to row 1, column 1, if neither the 
address specified by the IC nor the first non-bypass field is given. 


The associated Cmd AID byte is generated and sent to the AS/400 system 
preceding the first input field; sending the input fields can be inhibited by coding 
bytes 5-7 of the SOH order. 


The signal keys cause the 5494 to send an SNA command to the AS/400 system. 
These keys are: 


e Attn 
¢ Help (from error state). 


When the operator presses a signal key, the 5494 sends a SIGNAL command to 
the AS/400 system. 


Attention Key 

The Attention (Attn) key is valid when the keyboard is locked or unlocked. Pressing 
the key does not affect the state of the keyboard or of the cursor position. The 
workstation operator uses the Attn key to alert the AS/400 system that a requested 
function (such as enter) is not being honored. 


Help Key (from Error State) 

The workstation operator uses the Help key during an error condition to request 
that the AS/400 system send data about the error to the display. The 5494 sends 
a SIGNAL command to the AS/400 system containing columns 2 through 5 (which 
is the error code) of the error line in the user bytes of the SIGNAL command on the 
LU-LU flow. If the workstation operator uses the Help key a second time, bytes 2 
through 5 of the error line return to the AS/400 system. 
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Special Control Keys 


The special control keys and key sequence allow the workstation operator to alter 
operator-generated information on the display. They do not work when the 
keyboard is locked. The following are special control keys for workstations (not all 
apply to every workstation): 


e Delete 

Display Mode (key sequence) 

Erase Input 

Error Reset 

Hex 

Home 

Insert 

e Shift (Shift Lock on typewriter-like keyboard) 

e Alpha (Numeric Shift on data entry keyboards) 
e Alternate cursor. 


Delete Key 

To use the Delete key, the workstation operator first presses and holds one of the 
Shift keys, and then presses the Delete key. (On some keyboards, the Delete key 
can be pressed by itself.) The result is a deleted character in the position where 
the cursor was located. (All remaining characters in the field then shift to the left to 
fill the column vacated by the deleted character.) 


Display Mode 
This is not a single key but rather a key sequence. The workstation operator uses 
the following sequence to enter Display mode: 


1. Press the Cmd key. 
2. Press and hold the Shift key. 
3. Press the leftmost blank key on the top row of the keyboard. 


The workstation operator can adjust the display while in the Display mode. 
Normally, the screen displays light characters on a dark background. Using Display 
mode, the workstation operator can change this to dark characters on a light 
background. 


Note: Display mode is not available on the IBM 5292, 3179, 3180, 3196, or 3197 
display stations. | 


Erase Input Key 

This key works only on the unprotected fields that the workstation operator has 
modified. When the workstation operator presses either the Shift key along with 
the Erase Input key, or the Alt key along with the Erase Input key (depending on 
the keyboard type), all the modified fields are cleared to nulls and the cursor is 
moved to the first input field. The MDT bit remains on. 


Error Reset Key 
Depending on the state of the system, pressing the Error Reset key resets one of 
these states or modes: 


e¢ Operator error state 
¢ Command mode 

e System request state 
e Insert mode. 
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During these states, using the Error Reset key restores the original data on the 
error line of the display and resets the state. However, during the operator error 
state, this key is not operational from the time the workstation operator uses the 
Help key to the time the workstation operator receives the WRITE ERROR CODE 
command and contents from the AS/400 system. (The WRITE ERROR CODE 
command and contents are issued by the AS/400 system in response to the 
workstation operator using the Help key.) 


Hex Key 

On keyboards having a Hex key, hexadecimal codes are entered from the keyboard 
to generate any EBCDIC characters needed for input or display. The workstation 
operator: | 


1. Presses and holds the Alt key, then presses the Hex key. 


2. Enters the two-digit hex code for the character to be displayed. Valid entries 
are X'40' through X'FE'. 


On keyboards having a Cmd key, hexadecimal codes are entered from the 
keyboard to generate any EBCDIC character needed for input or display. The 
workstation operator: 


1. Presses the Cmd key, then presses the key to the right of the Cmd key. 


2. Enters the two-digit hex code for the character to be displayed. Valid entries 
are X'40' through X'FE'. 


Characters generated via hex mode are not valid in alphabetic only, numeric only, 
signal numeric, or digits only field. 


Note: FF is not a valid hexadecimal combination that can be typed on the 
workstation. Diacritics entered in this manner cannot be combined with another 
character. 


Home Key | 
The Home key moves the cursor to the position specified by the IC address. The 
IC is in the last WRITE TO DISPLAY command. If there is no IC order, the default 
is to the first non-bypass input field or, if there is none, to row 1, column 1 (the first 
input field). If the cursor is already in the home position when the workstation 
operator uses the key, the key functions as the record backspace key. 


Insert Key 

The Insert key sets the insert state for the field the workstation operator is in. The 
state must be reset before the workstation operator can leave the field. Pressing 
the Reset key or pressing the Insert key again resets the state. 


Shift and Shift Lock or Caps Lock Keys 

There are two shift keys and one Shift Lock or Caps Lock key on a typewriter-like 
keyboard. The shift keys not only put the keyboard into an uppershift condition, but 
also act in conjunction with the Sys Req, Delete, and Roll keys to do special 
functions. 


When pressed, the Shift Lock key sets the keyboard in the uppershift condition, and 
this condition remains when the key is released. To exit from keyboard shift lock 
state, the workstation operaior must press one of the two shift keys. If the 
workstation operator presses a shift key along with a special function key, the 
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inhibit downshift function will be enabled. If your keyboard has a Caps Lock key, 
press this key to get the mono case values of alphabetic characters that are on the 
keys. To leave Caps Lock mode, press the Caps Lock key again. 


Alpha and Numeric Shift Keys 

There are two shift keys on the data entry keyboards. The Alpha Shift key puts the 
keyboard into lower shift when the workstation operator wishes to select lower. 
symbols on the keytop in a programmed numeric field. The Numeric Shift key is 
used to select upper symbols on a keytop when in a programmed alpha field and 
also to select uppershift command functions. 


There is no shift lock on the data entry keyboards. 


Alternate Cursor 
Some displays allow the selection of either the bar-type or block-type cursor. Refer 
to the workstation operator’s guide. 


Special AS/400 System Keys 
The special AS/400 system keys are: 


e Sys Req 
e Test Request. 


Sys Req Key 

The Sys Reg key allows the display to enter the system request state. The key will 
not work when the display is in an error or SS state, or when the 5494 is 
processing a READ, WRITE, ROLL, SAVE, RESTORE, WRITE ERROR, or COPY 
command. Otherwise, the key is operational when the keyboard is in the locked or 
unlocked state. When Sys Reg is used to exit a field, all field requirements must 
be met or an error occurs and Sys Req is ignored. 


Using the Sys Reg key results in the following actions: 
e¢ Data on the error line is saved. 


e The error line is cleared. 


e Acolumn separator and an underscore field attribute are supplied for column 1 
of the error line. 


e The cursor is located under column 2 and polling for keystrokes begins. 


When the LU is in the system request state, a message can be entered. When the 
workstation operator presses the Enter/Rec Adv key, the 5494 sends the message 
to the AS/400 system on the SS-LU flow. No cursor address or AID codes are 
returned, embedded and leading nulls are converted to blanks, and trailing nulls are 
stripped. The resulting recovery depends on the state of the LU: 


e If the LU was in an LU-LU session, the previous contents of the error line are 
restored and the LU is returned to its pre-system request state. 


e If the LU was in an SS-LU session, the message stays on the display but has 
normal attributes assigned. The LU returns to the pre-system request state. 


. lf the LU had not been activated, it is restored to its pre-system request state 
and an operator error of 004X, 005X, or 0099 is posted. 
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Diacritic Keys 


Any replies sent on the SS-LU (FMD) session are posted on the error line. When 
the workstation operator presses the Error Reset key, the previous contents of the 
error line are restored and the LU returns to its pre-system request state. 


_ Test Request Key Sequence 


When the 5494 is enabled to access CSU or concurrent diagnostic information the 
5494 operator and service personnel use the Test Request key sequence to access 
CSU and diagnostic routines. The 5494 does not send information or AID codes to 
the AS/400 system when an operator enters this key sequence. 


For specific Test Request key sequences, refer to the [BM 5494 Remote Control 
Unit User’s Guide. 


Using a diacritic key places a diacritic (modifying) mark above or below a character 
to indicate a different sound or meaning for that character. 


Various diacritic keys are available. However, the only diacritic marks that can be 
entered are those that appear on the diacritic keys on the keyboard. Examples of 
the available diacritics are: 


~ (Grave Accent) 
~ (Acute Accent) 
~ (Tilde) 

A (Circumflex) 

.. (Diaeresis) 

C (Cedilla) 


To enter a diacritic above a character, the workstation operator presses the 
Diacritic key and then types the character. The 5494 or the AS/400 system then 
checks to see that the Diacritic key and the character key pressed are a valid 
combination. Valid combinations vary by country; examples of possible valid 
combinations are: 


Diacritics: Allowable Characters: 
~ (Grave Accent) AEIOU 
~ (Acute Accent) AEIOU 


~ (Tilde) ANO 

A (Circumflex) AE!IOU 

.. (Diaeresis) AE!OU y(y is allowable only as a lowercase character) 
¢ (Cedilla) C 


After the diacritic and character combination has been checked and found to be 
correct, the cursor moves to the next position. If the combination is not valid, a 
0029 error code is shown on the display screen. 


Additional Keyboard Functions 


The 5494 supports four additional keyboard functions: 


e Type-ahead 

e Extended graphics 

¢ 3270 local keyboard functions 
e Dual keyboard support. 
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Type-Ahead 


Type-ahead allows a workstation operator to continue typing after the keyboard is 
locked. Keystrokes entered while the keyboard is locked are saved in a buffer that 
can hold up to 32 keystrokes. When the keyboard becomes unlocked, these 
keystrokes are processed before new keystrokes. 


The default state for any workstation is type-ahead inactive (no keystrokes are 
saved when the keyboard is locked). To change from one state to the other, the 
workstation operator enters Hex mode and presses the K key. 


The operator can determine the current state of the workstation by entering Hex 
mode and pressing the M key. If 1111 is displayed on the error line, type-ahead is 
active. If 9999 is displayed, type-ahead is inactive. 


When the keystroke buffer is full, the workstation enters Buffer Full mode. In this 
mode, the Input Inhibited indicator is set, and the keyboard clicker is disabled. 
Only new keystrokes from the Sys Req and Error Reset keys are processed. If a 
Shift key is pressed, the key is flushed, the alarm sounds, and the keyboard clicks. 


The 5494 processes the Sys Req, Error Reset, and Shift keys as: 


Sys Req: The 5494 processes the Sys Req key whether the display is in 
Type-Ahead mode, Buffer Full mode, or if keystrokes are being processed from 
the buffer. In Buffer Full mode, however, the operator must press the Error 
Reset key prior to the Sys Req key to clear the buffer (if the Sys Req key is 
accessed through a Shift or Alt key). This is necessary because an input from 
the Shift or Alt key is flushed in Buffer Full mode and the shifted Sys Req key 
will not be recognized. 


When the operator presses the Sys Req key, Type-Ahead mode is not reset (if 
set) but the buffer is cleared and the display is put into system request state. 
All new keystrokes are processed while in system request state even if in 
Type-Ahead mode. When system request state is reset by pressing the Enter 
or Error Reset key, normal keystroke processing continues. 


Error Reset: The Error Reset key is processed whether the display is in 
Type-Ahead mode, Buffer Full mode, or if keystrokes are being processed from 
the buffer. When the operator presses the Error Reset key, Type-Ahead mode 
is not reset. The buffer is cleared and Buffer Full mode is reset (if set). After 
the 5494 processes the Error Reset key, normal processing of the buffer 
continues. If Type-Ahead mode is active, new keystrokes are buffered. 


Shift Keys: The 5494 tracks current status of Numeric and Alpha shift keys for 
data entry keyboards or left Shift, right Shift, Caps Lock, and Shift Lock keys 
for data processing keyboards, continuously. The 5494 saves the current state 
of the left and right Alt keys, the Latin and language keys, and Layer Select, 
Katakana Shift and Katakana Symbol Shift keys, if they apply to the particular 
keyboard being used. 
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The shift indicators and states are kept updated in real time while keys are 
being buffered. The 5494 updates the current state of these keys (make or 
break) whenever the buffer is cleared (Such as for Sys Reg or Error Reset 
keys, operator errors, the WRITE ERROR command, programming errors, or 
hard errors) or when Buffer Full mode is reset (after a keystroke space is freed 
up in the buffer). 


This is done because the “break” of these scan codes could be lost while 
flushing them in Buffer Full mode or clearing the buffer. If the “make” of these 
keys was already processed, users would be left in the make state when they 
do not want to be. 


Extended Graphics - Layer 100 


The 5494 supports an additional graphic layer on some Enhanced keyboards. This 
layer is comprised of accents and special characters. It is an addition to the 
primary layer on the keyboard and is accessed with the Alt + Shift key sequence. 


Note: This function is not supported on Enhanced keyboards for some countries. 
Contact your IBM customer service representative for additional information. 


3270 Local Keyboard Functions 


16-14 


Several 3270 local keyboard functions are available for the 5494. The following 
IBM keyboards support these functions: 


e Typewriter keyboard 
e 122-key keyboard 
e Enhanced (102-key) keyboard. 


IBM Typewriter Data Entry keyboards do not support the 3270 keyboard functions. 


3270 keyboard functions are available in DP mode only. If an operator selects any 
of these functions while in DP mode, operator error 0077 is posted. 


When the keyboard is in shift state, an operator can invoke the 3270 keyboard 
functions only by manual shifting, even if the keyboard is in Caps Lock or Shift 
Lock state. 


‘The 5494 supports the following 3270 keyboard functions: 


e Erase to End of Field (EOF) 
e Field Mark 

e¢ Cursor Select 

¢ Program Access (PA) 1-3. 


Erase End of Field 
The Erase EOF function is valid within any BnIproleeree entry input field. When an 
operator presses the Erase EOF key: 


e All character positions from and including the current cursor position through 
the end of the field are filled with null characters. 


e Any character attributes associated with the nulled characters are reset to their 
default values. 


e The current field MDT bit is set to on. 


e The cursor remains in its current position. 
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lf an operator presses the Erase EOF key within a protected field, operator error 
0005 is posted. 


Field Mark : 

The Field Mark function is valid within any unprotected entry input field in which the 
Dup or Field Mark key is allowed (FFW bit 3 set to on). The 5494 processes Field 
Mark the same as it does a data character key. The Field Mark character (X'1E') 
is displayed as an overscore on IBM 3180 and IBM 5251 display stations and as a 
space on all other supported workstations. 


If an operator presses the Field Mark key in an entry field that does not allow the 
Dup or Field Mark key, operator error 0019 is posted. The Field Mark code point is 
allowed in an outbound data stream. 


Cursor Select 

The Cursor Select function allows an operator to select an input field using the 
keyboard. This function can be used instead of the selector light pen (SLP) in 
these fields. 


Cursor Select is valid only in selectable fields. If an operator presses the Cursor 
Select key in a nonselectable field, operator error 0037 is posted. The AS/400 
system defines a selectable field by coding an FCW value of X'8102' or X'8103'. 


When an operator presses the Cursor Select key from any position on the screen, it 
is processed the same as an SLP tip switch in that position. 


Program Access (PA) 1-3 

The 5494 processes the PA keys the same as it does nondata AlD-generating keys 
such as Help, Print, or Clear. When an operator presses a PA key, one of the 
following AID codes is returned along with the current cursor address on the normal 
LU-LU flow: 


e PA1-AID X'6C' 
e PA2-AID X'6E' 
e PAS-AID X'6B'. 


No data is returned to the AS/400 system with any PA key AID. 


Dual Keyboard Support : 
You can attach workstations that support dual keyboards to the 5494. These 
workstations allow you, when configuring your workstations, to select either a 
Japanese Katakana keyboard or a U.S. English keyboard without changing the 
physical keyboard. In Japanese Katakana mode, the 5494 processes scan codes 
from the display the same as it would for a Katakana typewriter keyboard. In U.S. 
English mode, the 5494 processes scan codes from the display the same as it 
would far a U.S. English typewriter keyboard. 
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Chapter 17. Display Pointer Device (Mouse) Support 


Displays such as a 3486 can attach a pointer device, which is typically a mouse. 
The mouse functions that are supported by the 5494 are explained in the following 
sections. 


The display has two modes for mouse operations: 


e In the normal mode, the display sends events to the 5494 any time a button is 
pressed or released. In other words, typically the user presses and releases a 
mouse button and the 5494 receives and acknowledges a button-pressed event 
and a button-released event. 


The display sends a button double-click event to the 5494 if a button is 
pressed, released, and pressed again within a user-specified double-click time. 
In this instance, the 5494 receives and acknowledges a button-pressed event, ~ 
a button-released event, a button double-click event, and another 
button-released event. 


¢ In the mouse cursor movement mode, the display sends mouse cursor 
movement events to the 5494 at a predetermined rate, for example, once every 
100 ms. 


Note: The displays have a setup option to switch the functions of the left and right 
buttons within the display. The 5494 is not involved in this action. 


5494 Mouse Function Overview 


The 5494 provides default processing for the mouse buttons. The following list 
provides an overview of the functions available. For details on how the functions 
are processed, see the specific buttons listed in “Event Processing Specifics” on 
page 17-3. 


Copy and Paste Function 


The 5494 provides linear and block mode copy and paste for a display screen in 
DP mode. Linear and block mode are different if multiple rows are involved in the 
copy and paste. 


e Linear mode copies all the data between the two end points. 
e Block mode copies a rectangular area within the two end points. 


When the Shift key and the left mouse button are pressed, the mouse cursor marks 
an end point of the linear data to be copied. The user now moves the mouse 
cursor while holding down the left button. The bounds of the copy may be 
continually updated and presented to the user, by drawing lines around the copy 
data. When the left button is released, the mouse cursor now marks the other end 
point of the linear copy data. A block copy is performed by pressing the Shift key 
and double clicking the left mouse button, marking an end point. The other end 
point of the block copy data is determined when the left button is released. 


The marked copy of the data is stored in the 3486, 3487 or 3488 for later use. The 
user then positions the text cursor (not the mouse cursor) in the entry field where 
the data is to be pasted. When the user presses the Shift key and the right mouse 
button, the data previously marked is pasted at the location of the text cursor. 


© Copyright IBM Corp. 1992, 1995 | 17-1 


Note: Copy data remains in the display buffer until it is replaced with new data or 
until the display is turned off. It may be pasted to multiple locations if desired by 
moving the text cursor to a new location and again using the Shift key and the right 
mouse button. 


Reset Operator Error State Function 


lf an operator error is displayed, placing the mouse cursor on the operator error line 
and pressing the left button performs the Reset key function and clears the error. 


Hot Spot Function 


Hot spots enable an older application to use the mouse functions without 
reprogramming. For example, when the left button is pressed, the 5494 attempts to 
recognize such screen areas as: 


e Function key descriptions 

e +/— for scrolling 

e “More’/“Bottom” for scrolling 
e Menu items 


The 5494 returns the appropriate AID and information to the AS/400 system when 
the mouse cursor is positioned on one of these areas and the left mouse button is 
pressed. 


The 5494 also returns the appropriate AID and information to the AS/400 when the 
mouse cursor is positioned on “more” or “bottom” and the right button is pressed. 


The 5494 provides an Enter key AID function. When the left button is double 
clicked, the text cursor is moved to the position of the mouse cursor and the Enter 
key AID is sent to the AS/400 system. 


Operate Against a Scroll Bar Function 


The 5494 provides a Roll AID and cursor repositioning information to the AS/400 
system in response to pressing and releasing the left button with the mouse cursor 
on a scroll bar. 


e Pressing the left button on a scroll bar arrow typically causes a one-row or 
one-column scroll (this is dependent on application support). 

e Pressing the left button in the scroll bar shaft, above, below, or beside the 
scroll bar slider, typically causes a one-page scroll. 

e Pressing and holding the left button on the slider enables the mouse cursor to 
drag the scroll bar slider. When the left button is released, the drop function is 
performed and the appropriate AID information is sent to the AS/400 system. 


Select an Item in a Selection Field Function 


If the mouse cursor is placed on a selection field choice and the left button is 
pressed, the text cursor is moved to the position of the mouse cursor and the 
Space Bar selection function is performed. 
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Program the Mouse Buttons Function 


An AS/400 application program uses the PROGRAMMABLE MOUSE BUTTONS 
structured field to provide the 5494 with instructions for specific mouse button 
events. The 5494 processes mouse button events according to the information in 
the command. 


Light Pen Function 


If the mouse cursor is in a light pen field, pressing the left button provides the same 
function as if a light pen tip switch were activated. 


Position the Text Cursor Function 


Pressing the left mouse button can be used to position the text cursor to the 
location of the mouse cursor. 


Mouse Button Event Processing Exceptions 
A mouse button event is ignored by the 5494 if any of the following are true: 


e The keyboard is locked, except single-event programmable mouse buttons 
which may be defined as queued. 


e The 5494 does not have a pending read, except single-event programmable 
mouse buttons which may be defined as queued. 


e The keyboard is in system request state or SS message state. 


e The keyboard is in operator error state, except left button pressed, which can 
reset an operator error. 


e The 5494 has any stored type-ahead keystrokes. 
e The display is in WP mode. 


e The keyboard is locked for copy-to-print state. 


Mouse Button Effect on Keyboard Modes 
Mouse button event processing resets the following modes: 


e hexadecimal key mode 

e diacritic key mode 

e front face mode 

¢ command mode 

e ideographic character download mode 


Event Processing Specifics 


The Shift key on the keyboard may be used in conjunction with mouse events. 
Therefore, there are 18 possible mouse events defined: three buttons (left, right, 
and center) with three events (press, release, and double click) in two keyboard 
states (shifted and unshifted). 


Note: The Shift key or Shift Lock key must be held down for a shifted mouse 
event. Releasing the Shift key will not reset the Caps Lock state or the Shift Lock 
state if used for a shifted mouse event. 
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The 5494 processes these events in the order described under each event. This 
processing order allows certain default events to take precedence over other 
default events or application-defined events. Once one of the conditions is 
satisfied, the processing completes and no further checking is performed. 


Unshifted Left Button Pressed Event Processing 

lf the Shift key is not pressed and the 5494 receives a left button pressed event, 
the 5494 determines the position of the mouse cursor and attempts to perform one 
of the functions described in this section. 
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Functions Reference 


1. If the display is in operator error state, and the mouse cursor is on the operator 


error line, the operator error is reset. Otherwise, the mouse event is ignored in 
operator error state. This means no further checking is performed. 


. If the mouse cursor is on a selection field choice, the text cursor is moved to 


the location of the mouse cursor and the function of a Space Bar is performed. 
If the selection field choice cannot accept the cursor or the choice is null, the 
text cursor is not moved and operator error 0084 is posted. 


. If the mouse cursor is on a scroll bar, a Roll AID may be sent to the host. Ifa 


Roll AID is sent to the host, the field MDT is set to on, the text cursor may be 
moved to the position of the mouse cursor (if requested in the DEFINE 
SCROLL BAR FIELD structured field) and the keyboard is locked. 


The scroll bar is made up of a top and bottom arrow (or a right and left arrow), 
a shaft, and a slider that moves on the shaft. The location of the mouse cursor 
on the scroll bar determines the action that the 5494 takes when the event 
occurs: 


e If the mouse cursor is on the shaft above the slider, a Roll Down AID with a 
scroll increment of X'00000000' is sent to the AS/400. Similarly, if it is 
below the slider it causes a Roll Up AID, to the left of the slider a Roll Left 
AID, and to the right of the slider a Roll Right AID. 


e If the mouse cursor is on an arrow character and the slider is not already at 
the end of the scroll bar, a Roll AID for the correct direction with a scroll 
increment of X'00000001' is sent to the AS/400. If the slider is already at 
the end of the scroll bar, the left button pressed event is ignored. 


e If the mouse cursor is on the slider, a drag and drop function is started. 
The 5494 periodically calculates the row of the mouse cursor and 
compares this value with the last row that was processed. If the values are 
different, the scroll bar characters are rewritten by repositioning the slider 
within the shaft. When the left button is released, the drop function is 
performed. See “Unshifted Left Button Released Event Processing” on 
page 17-5 for a description of the drop function. If another mouse button 
event or keyboard event occurs before the left button is released, the scroll 
bar is rewritten to the original position and no AID is sent. 


4. If the mouse cursor is in a pointer device selection entry field, the text cursor is 


moved to the position of the mouse cursor, the keyboard is locked, and the 
specified AID is returned to the AS/400. 


. If the mouse cursor is in a light pen field, the 5494 acknowledges the event as 


if a light pen tip switch were activated at the position of the mouse cursor. 


. If this event has been programmed using the PROGRAMMABLE MOUSE 


BUTTONS structured field, the event is handled as described in 
“PROGRAMMABLE MOUSE BUTTONS Structured Field” on page 15-95. 


7. lf none of the above conditions is satisfied, the 5494 attempts to provide some 
simple hot spot functions. Hot spots enable a mouse to assist in driving older 
applications. _ To be considered a hot spot, the mouse cursor must not be in an 
entry field. 


The 5494 attempts to recognize and process the following left-button-pressed 
events as hot spots: 


e Using command key emulation, the 5494 attempts to recognize the mouse 
Cursor positioned on the command key text (for example, “F12=Cancel”). 
The keyboard is locked and the specified AID is returned to the host. 


e The 5494 attempts to recognize the mouse cursor positioned on scrolling 
requests based on a plus (+) or a minus (-). In some cases, More —/+ is 
used to indicate the data is scrollable. If the mouse cursor is on a -, the 
keyboard is locked and a Roll Down AID is sent to the AS/400 system. 
Similarly, if the mouse cursor is on a +, the keyboard is locked and a Roll 
Up AID is sent. | 


e The 5494 attempts to recognize the mouse cursor positioned on scrolling 
requests based on “More” and “Bottom” (English only). If the mouse cursor 
is on “More”, the keyboard is locked and a Roll-Up AID is sent to the 
AS/400 system. Similarly, if the mouse cursor is on “Bottom”, the keyboard 
is locked and a Roll-Down AID is sent to the AS/400 system. 


Note: Ifa right-button pressed event is received when the mouse cursor is 
positioned on “More”, a Roll-Down AID is sent to the AS/400 system. 


e The 5494 attempts to recognize the mouse cursor positioned on a menu 
choice (for example, “2. Office Tasks”). The number can be 1 to 5 digits 
and is placed in the entry field and an emulated Enter key AID is sent to 
the host. 


Note: The Enter key can also be emulated by a left button double click. 
See “Unshifted Left Button Double Click Event Processing” on page 17-6. 


8. If the mouse cursor was outside a selection field and the pull-down cancel 
mode is active that is, a selection field was written to the display screen and a 
pull-down cancel AID was specified in the DEFINE SELECTION FIELD major 
structure, the text cursor is moved to the position of the mouse cursor, the 
keyboard is locked, and the specified AID is returned to the host. 


9. If none of the preceding conditions is true, the 5494 moves the text cursor to 
the position of the mouse cursor. 


Note: The 5494 allows the text cursor to move to a non-cursorable text 
location, even if cursor movement to input-capable positions only is set to on. 


Unshifted Left Button Released Event Processing | 
If the shift key is not pressed and the 5494 receives a left-button-released event, 
the 5494 determines the position of the mouse cursor and attempts to perform one 
of the following functions: 


1. If the scroll bar slider is being dragged (see “Unshifted Left Button Pressed 
Event Processing” on page 17-4), this button event results in a drop of the 
Slider. The following may occur depending on mouse cursor position: 


e If the row position of the mouse cursor is different from the row position 
when the slider was last written, the scroll bar characters are rewritten. 
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e lf the final slider position (drop position) is different from the slider position 
when the drag was started, the MDT is set to on, the text cursor may be 
moved to the scroll bar slider, a Roll AID is sent to the AS/400 with a scroll 
increment indicating the number of rows or columns to be scrolled, and the 
keyboard is locked. The specific Roll AID depends on the direction the 
slider moved. If the slider did not move, no AID is sent. 


2. If a copy is active for the copy and paste function, this event is processed as a 


shifted left button released event (see Step 1 on page 17-7 in “Shifted Left 
Button Released Event Processing’). 


3. If this mouse button event has been programmed by using the 


PROGRAMMABLE MOUSE BUTTONS structured field, the event is handled as 
described in “PROGRAMMABLE MOUSE BUTTONS Structured Field” on 
page 15-95. | 


4. If none of the preceding conditions is met, the 5494 ignores this event. 


Unshifted Left Button Double Click Event Processing 

If the shift key is not pressed and the 5494 receives a left-button double-click event 
the 5494 determines the position of the mouse cursor and attempts to perform one 
of the following functions: 


1. If this mouse button event has been programmed by using the 


PROGRAMMABLE MOUSE BUTTONS structured field, the event is handled as 
described in “PROGRAMMABLE MOUSE BUTTONS Structured Field” on 
page 15-95. 


. If the previous left-button-pressed event positioned the text cursor (see Step 9 


on page 17-5 in “Unshifted Left Button Pressed Event Processing”), the 
keyboard is locked and the Enter AID is sent to the host. 


Note: When a user double clicks the left mouse button, the 5494 receives a 
left-button-pressed event, a left-button-released event, a left-button double-click 
event, and another left-button released event. 


3. If none of the preceding conditions is met, the 5494 ignores this event. 


Shifted Left Button Pressed Event Processing 

If the Shift key is pressed and the 5494 receives a left-button-pressed event, the 
5494 determines the position of the mouse cursor and attempts to perform one of 
the following functions: 
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1. If the display is in operator error state, and the mouse cursor is on the operator 


error line, the operator error is reset. Otherwise, the mouse event is ignored in 
operator error state. This means no further checking is performed. 


. If this mouse button event has been programmed by using the 


PROGRAMMABLE MOUSE BUTTONS structured field, the event is handled as 
described in “PROGRAMMABLE MOUSE BUTTONS Structured Field” on 
page 15-95. 


. The 5494 enters copy state (see copy and paste function in “5494 Mouse 


Function Overview” on page 17-1). The location of the mouse cursor is 
marked. This position marks the first of two locations that define the limits of 
the linear copy data; the locations can be marked in either order. If a keyboard 
event (other than Shift key release) or another mouse event occurs pale the 
left button is released, copy state is reset. 


Note: The 5494 supports copy and paste on single- and double-byte character 
set displays with line drawing capability and externally managed buffers. 


4. lf none of the preceding conditions is met, the 5494 ignores this event. 


Shifted Left Button Released Event Processing 
If the Shift key is pressed and the 5494 receives a left-button-released event, the 
5494 determines the position of the mouse cursor and attempts to perform one of 
the following functions: 


1. If the 5494 is in copy state (See copy and paste function in “5494 Mouse 
Function Overview” on page 17-1), the user has now marked the limits of the 
copy. The copy operation takes place even if the user releases the Shift key 
before the left button. The marked copy data is stored in the 348x display 
memory for later use or until the 348x is switched OFF. The type of copy, 
linear or block, is stored with the copy data, for use during a paste operation. 


2. If this mouse button event has been programmed by using the 
PROGRAMMABLE MOUSE BUTTONS structured field, the event is handled as 
described in “PROGRAMMABLE MOUSE BUTTONS Structured Field” on 
page 15-95. 


3. The 5494 enters copy state. (See “Copy and Paste Function” on page 17-1.) 
The location of the mouse cursor is marked. This position marks the first of 
two locations that define the limits of the linear copy data; the locations can be 
marked in either order. If a keyboard event (other than a Shift key release) or 
another mouse event occurs before the left button is released, copy state is 
reset. 


Note: The 5494 supports copy and paste on single- and double-byte character 
set displays with line drawing capability and externally managed buffers. 


4. If none of the preceding conditions is met, the 5494 ignores this event. 


Shifted Left Button Double Click Event Processing 


If the Shift key is pressed and the 5494 receives a left-button double-click event, 
the 5494 determines the position of the mouse cursor and attempts to perform one 
of the following functions: 


1. If this mouse button event has been programmed by using the 
PROGRAMMABLE MOUSE BUTTONS structured field, the event is handled as 
described in “PROGRAMMABLE MOUSE BUTTONS Structured Field” on 
page 15-95. 


2. The 5494 enters copy state (see copy and paste function in “5494 Mouse 
Function Overview” on page 17-1). The location of the mouse cursor is 
marked. This position marks the first of two locations that define the limits of 
the block copy data; the locations can be marked in either order. If a keyboard 
event (other than Shift key release) or another mouse event occurs before the 
left button is released, copy state is reset. 


Note: The 5494 supports copy and paste on single- and double-byte character 
set displays with line drawing capability and externally managed buffers. 


3. If none of the preceding conditions is met, the 5494 ignores this event. 
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Unshifted Right Button Pressed Event Processing 
If the shift key is not pressed and the 5494 receives a right-button-pressed event, 
the 5494 determines the position of the mouse cursor and attempts to perform one 
of the functions described in this section: 


1. If this button event has been programmed using the PROGRAMMABLE 
MOUSE BUTTONS structured field, the event is handled as described in 
“PROGRAMMABLE MOUSE BUTTONS Structured Field” on page 15-95. 


2. The 5494 attempts to recognize the following right-button-pressed event as a 
hot spot: 


If the mouse cursor is positioned on “More” or “Bottom”, the keyboard is 
locked and a Roll-Down AID is sent to the AS/400 system. 


3. If none of the preceding conditions is met, the 5494 ignores this event. 


Shifted Right Button Pressed Event Processing 
If the Shift key is pressed and the 5494 receives a right-button-pressed event, the 
5494 determines the position of the mouse cursor and attempts to perform one of 
the following functions: 


1. If this button event has been programmed using the PROGRAMMABLE 
MOUSE BUTTONS structured field, the event is handled as described in 
“PROGRAMMABLE MOUSE BUTTONS Structured Field” on page 15-95. 


2. If the user has previously performed a copy operation (see copy and paste 
function in “5494 Mouse Function Overview” on page 17-1), the 5494 attempts 
to paste the copied data. The copied data is entered into the entry field at the 
location of the text cursor (not the mouse cursor). The data is keyed into the 
entry field in the current keying mode, replace or insert mode, until all the data 
has been keyed, an operator error occurs, or an AID is sent to the host (paste 
into an auto-enter field). The 5494 performs the following checks and formats 
the data: 


e If the text cursor is not in an entry field, operator error X'0005' is posted. 
e The 5494 reads in the data from the display buffer. 


¢ Data following a non-display attribute is converted to blanks until another 
attribute is found. 


e Many code points less than X'40' (for example, attributes and GUl-like 
characters) are converted to blanks. SO (X'0E') and Sl (X'0F') 
characters are converted to blanks on non-ideographic caer displays. 
Nulls (X'00') are not converted. 


e¢ The 5494 then begins keying the copy data into the entry field, at the text 
cursor position. The 5494 performs normal field checks, such as numeric 
only or alpha only. This can result in an operator error. 


If the field is a monocase field, the data is changed to monocase. 


lf the copy data is block copy data, each line is pasted. At the end of each 
line, the text cursor is repositioned on the next line within an entry field, at 
the column position where the first line of copy data was pasted. 


3. If none of the preceding conditions is met, the 5494 ignores this event. 
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Other Mouse Button Events 
1. If the mouse button event has been programmed by using the 
PROGRAMMABLE MOUSE BUTTONS structured field, the event is handled as 
described in “PROGRAMMABLE MOUSE BUTTONS Structured Field” on 
page 15-95. 


2. If the preceding condition is not met, the 5494 ignores this event. 
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Chapter 18. Printer Data Streams 


The 5494 supports both Intelligent Printer Data Stream (IPDS) and SNA Character 
String (SCS) printers. The AS/400 system sends printer data streams consisting of 
control characters, commands, and the data required to print one or more lines of 
text. All standard printing functions are passed to the printer without parsing. 


Note: IBM assures program transparency for different printer types only when all 
printers attached to the 5494 respond to the same command set. Refer to the 
documentation for specific printers to obtain complete definitions for their 
commands. 


Intelligent Printer Data Stream 


Although the 5494 normally passes the IPDS through to the printer without parsing, 
it does monitor the data stream for two commands: 


e READ MULTIPLE STATUS (X'0047 0100') 
e RESET MULTIPLE STATUS (X'0047 0000'). 


These two commands regulate transfer of data from a status buffer in the printer to 
the AS/400 system. When the printer detects an error condition, it routes a single 
status byte (X'60') to the 5494 through the twinaxial interface. The status 
message prompts the 5494 to place a negative response of X'1005 0260' into the 
normal LU-LU flow for transmission to the AS/400 system. The AS/400 system 
then sends the READ MULTIPLE STATUS command to the printer through the 
5494. As a result of this exchange, the printer sends 256 bytes of status data to 
the 5494 for transmission for the AS/400 system. When the exchange has been 
completed, the AS/400 system issues the RESET MULTIPLE STATUS command, 
which returns the printer to the normal mode of operation. 


SNA Character String 


Because SCS printers respond directly to the data stream assembled by the 
AS/400 system, the 5494 passes the data to the addressed printer without parsing. 
lf a failure condition is detected, the 5494 returns a negative response to the © 
AS/400 system on the normal LU-LU flow. 
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Chapter 19. Communication Interfaces 


The 5494 supports the following communication interfaces to a modem or DCE: 


e ANSI-EIA 232D 
e CCITT X.21 
e CCITT V.35. 


Any modem or DCE attached to the 5494 must meet these interface specifications. 


When a communication line is activated, a cable wrap test is done. A cable wrap 
test checks signals sent from the sender to the receiver and back again. When the 
test is started, all transmitters and receivers are disconnected from the DCE. The 
DCE is isolated from the DTE during wrap testing. On CCITT X.21 connections, 
SET remains connected. 


The 5494 also supports the following interfaces to a local area network: 


e IEEE 802.5 (token-ring) 
e IEEE 802.3 (Ethernet) 


EIA 232D Interface Lines between the DTE and DCE 


The EIA 232D communication interface conforms with ANSI-EIA 232D and with 
CCITT Recommendation V.24/V.28 (X.21 bis interface). 


Figure 19-1 on page 19-2 shows the interface lines, the EIA 232D lead names, 
and the signal path. Pin numbers not shown are not used by the 5494. 
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DCE Lead Designation Line Name DTE 
Connector EIA/CCITT Connector 
(25-pin) (26-pin) 


SSS Shield 





<t— BA/103 — TD Transmitted data 


















BB/104 —— RD Received data. ———_____________»> 





<— CA/105 —— RTS Request to send 





CB/106 —- RFS ———- Ready for sending §§=——+——-_—____» 
CC/107 —- DSR ——— Data set ready —__—__________» 
Cable ID 0 ——» 


Cable ID 1 ——» 





AB/i02 —— SG Sig 





Data channel received 


CF/109 __RLSD —,,, signal-detector 


DB/114. —__ TSET Transmitter signal element timing > 





DD/115 —— RSET ——— Receiver signal element timing —_> 


<q— */141 —_ LL ——____ Local loopback 


CD/108.1 DTR/ —___ Data terminal ready 
/108.2 CDSTL connect data set to line 


CE/125 —— Cl Calling indicator =——-H——¥_______» 





«<q— CH/111 —— DSRS ~— Data signal rate selector 


Cable Wrap q— 








1 2 3 4 5 6 7 8 9 10 11 #12 = «13 







eo e@«eeeeeeeoeoeod dao oO 1 2 oe. 4 


Communications 10 11 12 13 14 15 16 17 18 


Cable 








Pin Numbers 0 e@ OC eo eo oOCcmeOOClCcoOCc ello @9eeeo2@dee ®e 
14 15 16 17 18% 19 20 21 22 23 24 25 e@eeeeoooe 
@®@e@eeoodode® 
® = Used 19 20 21 22 23 24 25 26 
O = Not used 


* Not defined by CCITT X.21 bis. Lines with an * may be used for different or conflicting purposes by some attached devices. 
** No continuity in static state. 


Figure 19-1. EIA 232D Interface Lines between the DTE and DCE 
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CCITT V.24/V.28 EIA 232D Signal Line Descriptions 


Transmitted Data (TD for V.24, TX for V.28): Digital data signals generated and 
sent from the 5494 to the modem or DCE for transmission to the AS/400 system. 


Received Data (RD for V.24, TX for V.28): Digital data signals generated by the 
modem or DCE from the signals received on the communication line and sent from 
the modem or DCE to the 5494. 


Request to Send (RTS): A signal generated by the 5494 to put the modem or 
DCE in Transmit mode. 


Ready for Sending (RFS): A signal generated by the modem or DCE that 
indicates to the 5494 that the modem or DCE is ready to transmit data. RFS is 
usually active in response to RTS active. This signal is also known as clear to 
send (CTS). 


Data Set Ready (DSR): A signal generated by the modem or DCE that, when 
active, indicates one of the following: 


e For a nonswitched line and a switched line with manual answer, DSR indicates 
the modem or DCE is ready to operate. 


e For a modem or DCE with a switched line auto-answer setup, DSR indicates 
the modem or DCE is connected to the communication line and is ready to 
operate. 


Signal Ground: The common ground for all signal lines. 


Data Channel Received Line Signal Detect (RLSD): (Also known as carrier 
detect.) A signal generated by the modem or DCE to indicate to the 5494 that a 
carrier signal is present on the communication line. 


Transmitter Signal Element Timing (TSET): Generated by the modem to supply 
timing pulses to the 5494. These pulses control the shift of data bits from the 
transmit buffer to the modem or DCE. 


Receiver Signal Element Timing (RSET): Generated by the modem or DCE to 
supply timing pulses to the 5494. These pulses control the shift of data bits from 
the modem or DCE to the receive buffer. 


Local Loopback (LL): A signal generated by the 5494 that conditions the modem 
or DCE to do a local modem or DCE wrap test. The wrap test is done if the 
modem or DCE supports the wrap function and the use of the signal line. The 
transmit data from the 5494 is looped back on the receive line to the 5494. 


Data Terminal Ready (DTR): One of two uses (the other is CDSTL) that can be 
selected during configuration. Both use the same signal line (20). In DTR, this 
signal indicates to the modem or DCE that the 5494 is ready to operate. 


When the modem or DCE has the auto-answer function, DTR also prepares the 


modem or DCE to answer a call, connects the modem or DCE to the 
communication line, and maintains that connection until DTR is inactive. 
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During automatic answering, the connection to the communication line is in 
response to the DTR being active. An acceptable connection (off hook) activates 
DSR. An inactive DTR causes the auto-answer function to deactivate the 
communication line connection (on hook). DTR usually goes inactive when the 
transmission of data completes. 


Connect Data Set to Line (CDSTL): A usage similar to DTR that is used with 
some World Trade modems or DCEs. CDSTL uses the same signal line as DTR 
(20) and is selected by configuration bit 5. In CDSTL, this signal indicates to the 
modem or DCE that the 5494 is ready to operate. 


On a nonswitched communication line, the CDSTL signal is active in response to 
the DSR being active. 


On a switched communication line, CDSTL is active in response to DSR being 
active (this occurs when the line connection is made through a call placed to the 
AS/400 system), or in response to calling indicator being active (this indicates to 
the modem or DCE that the 5494 is ready to answer the incoming call). 


Calling Indicator (Cl): A signal generated by the modem or DCE to indicate to the 
5494 that a ringing signal is being received on the communication line. This signal 
is also known as ring indicator (RI). 


Data Signal Rate Selector (DSRS): (Also known as speed select.) A signal 
generated by the 5494 and used by modems or DCEs that can use either of two 
transmission speeds over the same communication line. When this signal is active, 
the lower speed is selected. 


Note: The polarity for the rate select signal is opposite that for all other control 
lines. 


EIA 232D Connector Mechanical Information 
Table 19-1 describes the EIA 232D connector. 


Table 19-1. EIA 232D Connector Description 


Part Description 

DCE interface —_ ISO 2110 (25-pin) 
Pin 1mm diameter 
Thumbscrews UNC 4.401 


1 M2.6 included for Japan and South Korea. M3 included for Germany. 
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EIA 232D Cable Wrap 
Figure 19-2 shows the cable wrap path for EIA 232D. 


Signal Line DCE 5494 Wrap Path 
TD 2 6 
RD 3 13 
TSET 15 12 
RSET 17 11 
DTR/CDSTL 6 2 cout 
DSR 20 18 
RTS 4 7 
DSRS 23 8 
LL 18 26 
Cable iD = 10 


Figure 19-2. EIA 232D Cable Wrap 


CCITT X.21 Interface Lines between the DTE and DCE 


The X.21 communications interface conforms with the interface circuit and electrical 
characteristics defined in CCITT Recommendation X.24/X.27 (V.11). The interface 
operates as described in CCITT Recommendation X.21. 


Figure 19-3 on page 19-6 shows the interface lines, the X.21 lead names, and the 
signal path. Pin numbers not shown are not used by the 5494. 
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DCE — Lead Designation Line Name DTE 
Connector CCITT Connector 
(15-pin) (26-pin) 




















———————— Shield: ———shiell 

) Transmitted data (A) 
) ——___———- Transmitted data (B) 
Received data (A) ————> 
Received data (B) —————> 
Control (A) 
Control (B) 
Indicate (A) -—————_——_——_» 
Indicate (B)_ —————————__> 
SET (A) ——————— 
SET (B) —————> 


Signal Ground 
— Cable ID 0 
Cable ID 1 


Cable wrap 


10 1112 13 14 15 16\7 18 
@®ooocoe@eoodod ®@ 


@®c@eeeoeedeo 
O8@80O 880 


Communications 
Cable 
Pin Numbers 


19 20 21 22 23 24 25 26 


@ = Used 
© = Not used 
* Used by 5494 to determine which cable type is being used. 


Figure 19-3. X.21 Interface Lines between the DTE and DCE 


X.21 Signal Line Descriptions 


Transmitted Data (TD(A) and TD(B)): A differential pair of digital data signals 
containing data sent from the 5494 to the DCE. 


Received Data (RD(A) and RD(B)): A differential pair of digital data signals 
containing data sent from the DCE to the 5494. 


Control (C(A) and C(B)): A differential pair of digital data signals that transmits 
control status to the DCE. 


Indicate (I(A) and K(B)): A differential pair of signals that transmits control status 
from the DCE to the 5494. 


Signal Element Timing (SET(A) and SET(B)): A differential pair of signals 


generated by the DCE to provide data synchronization for both transmit and receive 
signals. 
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Signal Ground: The common ground for all signal lines. 


Byte Timing (BT(A) and BT(B)): These signals are not used by the 5494. 


X.21 Connector Mechanical Information 
Table 19-2 describes the X.21 connector. 


Table 19-2. X.21 Connector Description 


Part 
DCE interface 
Pin 


Thumbscrews 


X.21 Signal Levels 


Description 
ISO 4903 


1 


mm diameter 


M3 


The X.21 physical interface includes five balanced differential interchange circuits. 
Because the signal characteristics of these circuits are not compatible with logic 
levels used by the microprocessing unit (MPU), drivers and receivers on the planar 
supply the necessary signal conversion. Each driver and receiver controls a 
separate pair of interchange lines (designated A and B). Table 19-3 indicates valid 
voltage ranges for VA, VB, and VA-VB. | 


Table 19-3. Signal Line Voltage Levels for the X.21 Interface 


Voltage Reference 
VA 

VB 

VA-VB 

VA-VB 

VA-VB 


DC Voltage Range Network Definition 
-10 V to +10 V 

-10 Vto+10V 

+0.3 V to +6.0 V Mark 

-0.3 V to -6.0 V Space 
-0.3Vto+03V Not valid 
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CCITT X.21 Cable Wrap 
Figure 19-4 shows the cable wrap path for CCITT X.21. 


Signal Line DCE 5494 Wrap Path 


T (A) 2 25 


R (A) 4 13 


21 


C (A) 3 24 


C (B) 10 16 


yp A 
G B 
= co 
—_h 
NI 


| (B) 12 10 


Set is connected to DCE during wrap. All other lines disconnected. 
Cable ID = 00 


_ Figure 19-4. CCITT X.21 Cable Wrap 


CCITT V.35 Interface Lines between the DTE and DCE 


The V.35 communications interface conforms with the interface circuit and electrical 
characteristics defined in CCITT Recommendation V.35. Figure 19-5 on 

page 19-9 shows the interface lines, pin usage for the connectors, and labels for 
the signal lines. Pin numbers not shown are not used by the 5494. 
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DCE Lead Designation 
Connector CCITT 
(34-pin) 

109 —— RLSD —— 
C 105 ——— RTS ——— 
D:: F106 == AS 
E F407 = DSR 
H 106.23 DR 
P 103 ——— TD (A) —— 
R }-— 104 —— RD (A) —— 
Vv |-— 115 —— RSET (A) — 
Yo 4: SS ISEL (A 
S == 103: 1D (Bp 
T j= 104--—— AD (8) —— 
X |-— 115 —— RSET (B) — 
AA TSET (B) — 
B 





DTE 
Connector 
(26-pin) 


Line Name 


Received line signal detector 
Request to send 
Ready for sending 


Data set ready 
Data terminal ready/ 
connect data set to line 


Transmitted data (A) 


Received data (A) 
Receiver signal element 
timing (A) 

Transmitter signal element 
timing (A) 

Transmitted data (B) 


Received data (B) 

Receiver signal element 

timing (B) 

Transmitter signal element __.___ ss 
timing (B) 

Signal ground 


Cable 
Cable ID 1 





Shield Shell 


Data signal rate selector <—————— 


Cable Wrap <————__- 





B ee. @ A 
rf D e*e® E © Wrap phase A <————___________ 
J 0A @ H 
L O70 K 
N O20 M Wrap phase B  <———__________- 
R ee. @ P 
v Tl e®o® ly § 
x @. 0 W Local loopback <—————_——- 
Z O,®@ Y 
Oro Calling indicator 1+ ———————————_|_ 3 
gy FF O56 | HH EE 
LL KK 
NN OO MM Communications 
coe 12 3 4.5 6 7 8 9 
Pin Numbers 10 11 12 13 14 15 16 17 18 
@ — Used 
O = Not used @©oeoeeeoecee@°® 


* Used by 5494 to determine which cable type is being used. 


** No continuity in static state. 


Note: DSRS, LL, and Cl signals are present only for the 
purposes of wrap testing. 







O0O@8@@e@@e8@e@00 ®@ 


@©e@eoee8ee 8 
19 20 21 22 23 24 25 26 


Figure 19-5. V.35 Interface Lines between the DTE and DCE 
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V.35 Signal Line Descriptions 
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Data Channel Receive Line Signal Detect or (RLSD): A signal generated by the 
modem or DCE that indicates to the 5494 that a carrier signal is present on the 
communication line. This signal is also known as data carrier detect (DCD). 


Request to Send (RTS): A signal generated by the 5494 that puts the modem or 
DCE into Transmit mode. 


Ready for Sending (RFS): A signal generated by the modem or DCE that 
indicates to the 5494 that the modem or DCE is ready to transmit data. RFS 
usually becomes active in response to RTS. This signal is also known as 
clear-to-send (CTS). 


Data Terminal Ready (DTR): DTR is not included in Recommendation V.35, but it 
is included in the communications cable and used for wrap testing. This signal 
cannot be used by V.35 modems or DCEs. 


Data Set Ready (DSR): A signal generated by the modem or DCE that indicates 
to the 5494 that it is ready to begin active operation. 


Transmitted Data (TD(A) and TD(B)): A differential pair of digital data signals that 
the 5494 sends to the modem or DCE. These signals contain the information that 
is transmitted by the 5494 through the external communications network. 


Received Data (RD(A) and RD(B)): A differential pair of digital data signals that 
the modem or DCE sends to the 5494. These signals contain the information that 
is transmitted to the 5494 through the external communications network. 


Receiver Signal Element Timing (RSET(A) and RSET(B)): A differential pair of 
timing pulses generated by the modem or DCE. These pulses control the rate of 
data transfer from the modem or DCE to the 5494. 


Transmitter Signal Element Timing (TSET(A) and TSET(B)): A differential pair 
of timing pulses generated by the modem or DCE. These pulses control the rate of 
data transfer from the 5494 to the modem or DCE. 


Signal Ground: This signal line supplies a common reference level for the 
single-ended interchange lines (RLSD, RTS, RFS (CTS), DTR, and DSR). 
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V.35 Connector Mechanical Information 
Table 19-4 describes the V.35 connector. 


Table 19-4. V.35 Connector Description 


Part Description 
DCE interface ISO 2593 
Pin 1.6 mm 


V.35 Signal Levels 


The V.35 interface includes both single-ended and differential signal lines. The 
single-ended signals operate within the same voltage range as EIA 232D signal 
lines. The differential lines consist of balanced, current-mode signals that develop 
line voltage across termination resistors. Table 19-5 identifies the voltage ranges 
associated with both types of signal lines. 


Table 19-5. Signal Line Voltage Levels for the V.35 Interface 


Line Type Voltage Reference DC Voltage Range Network Definition 
Single-Ended Interchange Signal line to GND +3 to +15 V Off or Logic 0 
Lines -3 to -15V On or Logic 1 
-3 to +3 V (exclusive) Not valid 
Differential Lines VA to GND -4to +4 V 
VB to GND -4to +4 V 
VA-VB +0.44 to +0.66 V Off or Logic 0 
VA-VB -0.44 to -0.66 V On or Logic 1 
VA-VB -0.44 to +0.44 V Not valid 
(exclusive) 


Note: The state of data circuits is denoted by logic 0 (also called space) and logic 1 (also called mark). 
Corresponding states of interchange circuits are identified as Off and On. 
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V.35 Cable Wrap 
Figure 19-6 shows the cable wrap path for V.35. 


Signal Line DCE 5494 Wrap Path 
RLSD F 1 
Cl 3 
DSR H 18 , 
RFS D 4 
T (A) Pp 15 
R (A) R 13 
RSET (A) V 11 gee te ae 
TSET (A) Y 12 
T (B) S 23 
R (B) T 24 
RSET (B) X 19 B Seeteneence nna ere 
TSET (B) AA 20 
Cable ID =01 


Figure 19-6. V.35 Cable Wrap 
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Token-Ring Interface 


This section describes the physical interfaces of the IBM Token-Ring network. For 
a complete description, refer to the IEEE 802.5 standard. 


interface at Wall Connector 


Input (to attaching product) 4 Mbps 16 Mbps 
Receive data (RX) level A B 50 mV _ 150 mV — 

| p-p pp 
Maximum bit outage time C _ 15 ms _ 15 ms 
Maximum freq error (operating) D ~ 0.01 % — 0.01 % 
Maximum freq error (nonoperating) E — 400 kHz ~ 2.7 MHz 
Input impedance F 135 Q 165 Q 135 Q 165 Q 
Wire fault conditions G _ - _ - 
DC termination H - 10 Q _ 10 Q 
Output (from attaching product) Minimum Maximum Minimum Maximum 
Transmit data (TX) level 3.0 V p-p 4.5 V p-p 3.0 V p-p 4.5 Vp-p 
Rise times i5ns 60 ns Oo Oo 
Asymmetry — 11 ns _ 3.0 ns 
Jitter | _ 2.2ns _ 3.0 ns 
Jitter J _ 7.0 ns _ 4.7 ns 
Jitter peaking K = 0.005 dB = 0.006 dB 
Maximum bit outage L — 4 half-bits _ 4 half-bits 
Frequency error E _ 400 kHz — 2.7 MHz 
Bit error rate M _ 10-11 — 10-9 
Phantom drive (at 4.1 V) 1 mA ~ 1 mA _ 
Phantom drive (at 0 V) 4mA 20 mA 4mA 20 mA 


Output (line) impedance N 135 Q 165 Q 135 Q 165 Q 


Physical (see Figure 19-9 on page 19-17) 


TX orange, 
black 
RX red, 
green 
Notes: 


A Occurring over 140° area at the center of the half-bit time and measured 
after a passive equalizer with: 


¢ A pole at 2.7 MHz, a pole at 16 MHz, and a zero at 540 kHz for 4 Mbps 
operation 


e A pole at 10.3 MHz, a pole at 25.0 MHz, and a zero at 2.4 MHz for 16 
Mbps operation. 
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The signal should be measured with the data wrapped at the connector. 


The adapter must function with a peak-to-peak input jitter EOnSIsing ofa 
single frequency for the following values: 


At 4 Mbps 


e Less than 687 ns below 2.0 kHz 
e Decreasing 20 dB/decade between 2.0 kHz and 55 kHz 
e Less than 25 ns above 55 kHz. 


At 16 Mbps 


e Less than 937 ns below 1.8 kHz 
e Decreasing 20 dB/decade between 1.8 kHz and 270 kHz 
e Less than 6.2 ns above 270 kHz. 


Because of switching time of wiring concentrator. 
Averaged for more than 60 seconds. 


Instantaneous frequency can be off by 400 kHz for as long as 50 us during 
certain error conditions. The adapter must be able to recover from this 
condition. 


Impedance into either the receiver or the driver at 4 MHz. 
Values are effective resistances as seen from phantom drive. See 
Figure 19-7. 


Attaching Product 


Card 


— Signal 
Ground 


Figure 19-7. Resistances Seen from Phantom Drive 
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Wire fault must be active (fault indicated) when: 


(4.3 KQ < Ra < 5.5 KQ) and (Rb > 50.0 KQ) or (4.38 KQ < Rb < 5.5 KQ) and 
(Ra > 50.0 KQ) or (Ra < 0.1 KQ) or (Rb < 0.1 KQ) 


Wire fault must be inactive (fault not indicated) when: 


(2.9 KQ < Ra < 3.82 KQ) and (2.9 KQ < Rb < 3.82 KQ) or (4.3 KO = Ra = 
5.5 KQ) and (4.3 KQ < Rb < 5.5 KQ) 


Ra 
(K (2) 


These regions are shown in Figure 19-8, where A indicates an active wire 
fault, | indicates an inactive wire fault, and D is the region where the wire 
fault can be either active or inactive. 


50.00 


4.30 











0.00 sh [ise 
0.00 0.10 290 3.82 430 5.50 50.00 


Rb(K ©) 


Figure 19-8. Active and Inactive Wire Fault Regions 


O2ZzesegerRKR G 


Resistance (dc) from receive lines to ground. 


Peak-to-peak phase error between the recovered clock and the clock of the 
upstream workstation when the data pattern is 500 bytes of B'0's alternating 
with 500 bytes of B'1's. 


Peak-to-peak phase error when the data pattern is all B'0's. 

Maximum gain of the phase transfer function of the timing recovery circuit. 
Maximum number of Manchester half-bits without a transition. 

Measured with the transmitter repeating the received data. 

Impedance into either the receive or the transmit twisted-pair cable at 4 MHz. 


At 16 Mbps, rise times are not adequate to describe transmitter waveform. 
Refer to frequency characteristics given in the IEEE 802.5 standard. 
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Interface at Wiring Concentrator (Multistation Access Unit) | 


Input (to wiring concentrator) Minimum Maximum 
Phantom voltage 3.9 V 5.2V 
Phantom current (at 4.1 V) 1 mA _ 
Phantom current (at 0 V) 4mA 20 mA 
Phantom interruption A _ 50 ms 
Output (from wiring concentrator) Minimum Maximum 
Attachment time B - 5 sec 
Removal time C 50 ms 200 ms 
DC resistance D 4.3 kQ 5.5 kQ 
Insertion Loss (maximum) 
10 kHz: 0.5 to 4 MHz: 4 to 16 MHz: 16 to 32 MHz: 
MRI to MRO - 0.3 dB 0.6 dB 1.2 dB 
TX to RX E 3.0 dB 0.65 dB 1.3 dB 2.6 dB 
MRI to RX 3.0 dB 0.55 dB 1.1 dB 2.2 dB 
TX to MRO 3.0 dB 0.55 dB 1.1 dB 2.2 dB 
TX to RX F 3.0 dB 0.8 dB 1.6 dB 3.2 dB 
Crosstalk (maximum) 
| 10 kHz: 0.5 to 4 MHz: 4 to 16 MHz: 
TX to RX 55 dB 43 dB 37 dB 
Lobe wrap to MR 55 dB 43 dB 37 dB 
MR to BR 59 dB 47 dB 41 dB 
Return Loss (minimum) 
1 to 6 MHz: 6 to 12 MHz: 12 to 24 MHz: 
20 dB 14 dB 11 dB 
Common Mode Rejection (minimum) 
1 to 6 MHz: 6 to 12 MHz: 12 to 24 MHz: 
40 dB 28 dB 25 dB 
Physical (see Figure 19-9 on 
page 19-17) 
Main Token-Ring path — In (MRI) red, green 
Main Token-Ring path — Out (MRO) red, green 


Backup Token-Ring path — In (BRI) 
Transmit data (TX) 

Backup Token-Ring path — Out (BRO) 
Receive data (RX) 


orange, black 
orange, black 
orange, black 

red, green 
Notes: 


A Attachment to the Token-Ring network must not be compromised by 
phantom interrupts up to the specified time. 


B Time from application of phantom drive to attachment to the Token-Ring 
network. 


C Time from removal of phantom drive to reconfiguration of the Token-Ring 
network. 


D From transmit wire to receive wire (red-to-orange, green-to-black). 
Transmit to receive each lobe. 


F Each transmit to receive last lobe. 
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Figure 19-9 shows the connector used throughout the Token-Ring network. 


Shorting Bars 





Figure 19-9. IBM Cabling System Data Connector (Interior View) 


Ethernet Interface 


The 5494 supports the IEEE 802.3 standard Ethernet interface using: 


e Acategory 3, 4, or 5 telephone twisted-pair cable with RJ-45 connectors for 


Ethernet networks using twisted-pair (10BASE-T) media. The maximum length 
of twisted-pair cable between the concentrator and the 5494 is 100 m (328 ft). 


An RG-58 standard coaxial cable (IEEE standard 802.3 10BASE2) with 
bayonet connectors (BNCs) for Ethernet networks using thin coaxial media. 
The maximum length of thin coaxial cable between two repeaters is 185 m (607 
ft). The minimum length is 0.5 m (19.5 in.). 


Note: A BNC T-type connector is shipped with the 5494 Ethernet Adapter kit. 


A shielded-twisted-pair drop cable with 10BASE5 attachment unit interface 
(AUI) connectors, for Ethernet networks using external transceivers. An IBM 
Mini AUI-to-AUI Adapter Cable (P/N 59G9004) is also required. The maximum 
length of drop cable between two transceivers is 50 m (164 ft). 


The user provides all Ethernet cables. 


For more information about Ethernet cabling, refer to the IEEE 802.3 standard or 
the [BM LAN Cabling System Planning and Installation Guide. 
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Appendix A. Ideographic Enhancements 


This appendix contains information about ideographic data entry and processing. 
Topics include: 


Double-byte and single-byte characters 
Alphanumeric and Ideographic modes 
Systems Network Architecture (SNA) support 
Display data streams 

AS/400 system extended ideographic support 
e Keyboard functions. 


Double-Byte and Single-Byte Characters 


The 5494 ideographic function allows you to print and display double-byte 
characters on Oriental language workstations. 


Double-byte (ideographic) and single-byte (alphanumeric) characters differ in the 
following ways: 


e Double-byte characters are enclosed by shift control characters. X'OE' begins 
the ideographic data stream. X'OF' or a screen attribute returns the keyboard 
to alphanumeric entry. 


e Double-byte characters are enclosed by extended ideographic data type 
attributes. 


e Double-byte characters, when displayed and printed, are usually twice as wide 
as single-byte characters and always occupy two screen positions. 


e Each double-byte character uses 2 bytes of storage; single-byte characters use 
only 1 byte. 


Note: When you enter double-byte versions of single-byte characters, the 
characters are considered double-byte, using 2 bytes of storage and occupying two 
screen positions. 


Refer to your workstation documentation for more information on double-byte 
character sets (DBCS). 


Alphanumeric and Ideographic Modes 


You can enter data at an ideographic workstation in either Alphanumeric or 
ldeographic mode. Use Alphanumeric mode to enter single-byte characters. To 
display and print double-byte characters, use either alternate entry or double-byte 
direct entry in the Ideographic mode. 


Alphanumeric Mode 


Use Alphanumeric mode when entering single-byte characters into non-ideographic 
input fields or subfields. In Alphanumeric mode, the keyboard operates as it does 
on non-ideographic workstations. 
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Ideographic Mode 


A-2 


Use either alternate entry or double-byte direct entry to enter data in Ideographic 
mode. 


Alternate Entry 

Alternate entry allows you to enter a decimal code for the desired character. A 
dictionary of alternate characters provides the decimal code for the characters. 
Enter this code (5 digits maximum) with the most significant digit first. The 5494 
converts the decimal code into a double-byte ideographic code. If the ideographic 
code is located in the display character-generating read-only storage (ROS), the 
5494 loads the ideographic code into the workstation buffer to display the © 
character. 


Codes not located in display ROS are called extension characters. The 5494 
sends these extension characters to the AS/400 system for comparison against an 
extension character random access memory (RAM) list that is maintained for the 
display. If the AS/400 system finds the extension character in the list, the AS/400 
system sends the RAM address and the extension character back to the 5494 with 


~ aLOAD MATRIX command. The 5494 writes the RAM address into the 


workstation buffer to display the extension character. If the AS/400 system does 
not find the extension character in the RAM list, the list is updated with a new RAM 
address. The AS/400 system returns the extension character, the new RAM 
address, and a bit matrix (representing the character image) to the 5494. The 5494 
loads the bit matrix into extension character RAM and writes the RAM address into 
the workstation buffer to display the character. 


The following rules apply for alternate entry operations: 


e The keyboard must be in Ideographic mode. The 5494 automatically selects 
this mode when the cursor enters an ideographic input field or subfield through 
automatic mode shift. 


e Only the numeric pad keys (0-9) on the right side of the keyboard are valid for 
alternate entry. You must enter each decimal digit from the numeric pad. 
Although numeric digits (O—9) also appear on the top row of data keys, they are 
reserved for double-byte direct entry and are not used for alternate entry. All 
data keys outside the numeric pad are valid only for double-byte direct entry in 
Ideographic mode. 


e The Enter key is interpreted as Alternate Enter when in alternate entry state. 
e The Reset key is interpreted as Alternate Clear when in alternate entry state. 


e Double-byte direct entry overrides alternate entry operation and clears alternate 
entry state. 


e Use the space bar to enter double-byte blanks (X'4040'). If the keyboard is in 
alternate entry state, the space bar overrides the alternate entry operation and 
clears alternate entry state. 


Double-Byte Direct Entry 


' All characters and symbols on the keyboards have a double- -byte representation in 


the IBM Ideographic Character Set and are implemented in the display 
character-generating ROS. This allows the 5494 to translate the data keys directly 
into double-byte characters for entry into ideographic input fields or subfields. 
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The following rules apply for double-byte direct entry: 


e The keyboard must be in Ideographic mode. The 5494 automatically selects 
this mode when the cursor enters an ideographic input field or subfield through 
automatic mode shift. 


e Only the data keys outside the numeric pad can be used for double-byte direct 
entry. The numeric pad is reserved for alternate entry sequences. A single 
exception is the numeric pad decimal point, which is a double-byte direct entry 
key. 


¢ Double-byte direct entry is allowed during alternate entry state, but it overrides 
the alternate entry operation and clears alternate entry state. 


e Numeric digits (0-9), which are keyed from the top row on the keyboard, are 
translated into double-byte numeric characters for direct entry. 


¢ Numeric digits (0-9), which are keyed from the numeric pad of the keyboard, 
are translated into a decimal code for alternate entry. 


¢ Data keys are translated as follows: 


— The right-half (point) is the single-byte EBCDIC translation for the 
character. 


— The left-half (ward) is either X'42' or X'43', depending upon the 
character. In either case, the double-byte code is assigned according to 
the IBM Ideographic Character Set standard. 


¢ The space bar is used to enter double-byte blanks (X'4040'). If the keyboard 
is in alternate entry state, the space bar overrides the alternate entry operation 
and clears alternate entry state. 


Systems Network Architecture Support 


The 5494 Ideographic function modifies the LUSTAT command. Other systems 
network architecture (SNA) commands are unchanged. 


The 5494 sends the LUSTAT command to the AS/400 system to report an 
extension character request. 


The extension character request has a status extension value greater than or equal 
to X'4040'. The extension LUSTAT is sent on the LU-LU normal flow. 


Display Data Streams 


For general information about data stream formats, see Chapter 15, “Display Data 
Streams.” The following information describes the format of data stream commands 
and responses specifically required for the ideographic support function. The topics 
include: 


¢ Commands 

e Field control word 
e Fields 

¢ Format Level 0. 
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Display Data Stream Commands 
The following commands and responses have requirements specific to the 
ideographic support function: 


READ MDT FIELDS 

READ SCREEN (IMMEDIATE) 
SAVE 

CLEAR FORMAT TABLE 
CLEAR UNIT 

RESTORE SCREEN 

ROLL 

WRITE ERROR CODE 
WRITE TO DISPLAY. 


READ MDT FIELDS | 
Trailing nulls are removed only if they are not enclosed by shift control characters. 
Nulls between shift control characters are not considered trailing. 


READ SCREEN (IMMEDIATE) 
On ideographic displays, all bytes, including those for shift control characters, are 
read from the display. 


SAVE SCREEN 
The 5494 automatically saves the unlocked keyboard in the current mode 
(Command, Insert, or Data Key). 
The 5494 does not save the following: 
e Keyboard modes (Ideographic or Alphanumeric) 


e History of previous keystrokes (shift status and accumulated extension 
character codes) 
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e Extension character RAM in the workstation 
e Display of shift control characters 


e Locked keyboard if caused by an extension character request. 


CLEAR FORMAT TABLE 

The 5494 clears any accumulated extension character codes. It does not clear the 
extension character RAM in the workstation or the displayed shift control 
characters. 


CLEAR UNIT 


The 5494 processes this command as follows: 
e Any accumulated extension character codes are cleared. 
e The cursor is set to nonblinking. 
e The keyboard mode (Ideographic or Alphanumeric) is not affected. 
e The display of shift control characters is not affected. 


e The RAM character generator and the extension character RAM in the 
workstation are not reset. 


RESTORE SCREEN 
The 5494 automatically restores the unlocked keyboard in the current mode 
(Command, Insert, or Data Key). 


Any extension character request LUSTAT that has been issued but not run is 
cleared and not restored. 
The following are not restored: 

e Keyboard modes (Ideographic or Alphanumeric) 


¢ History of previous keystrokes (shift status and accumulated extension 
character codes) 


e Extension character RAM in the workstation 
e Display of shift control characters 


e Locked keyboard if caused by an extension character request. 


ROLL 

Use caution when you roll ideographic fields that use more than one line. This 
ensures that shift characters and their associated characters are kept together to 
allow them to be displayed correctly. 


WRITE ERROR CODE 

The following actions are taken during the WRITE ERROR CODE command: 
¢« Any accumulated extension character codes are cleared. 
e Any extension characters are not displayed. 


e Any extension character request LUSTAT that has been issued but not run is 
not cleared and may be sent to the AS/400 system. 
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WRITE TO DISPLAY 

Double-byte characters should be enclosed by shift control characters, but the 5494 
does not verify that this is done. When the format table is modified, the 5494 
clears any accumulated extension character code. | 


When the format table is not modified, extension character request status is not 
affected by the WRITE TO DISPLAY command. Even if control character 2 (CC2) 
specifies that the keyboard should be unlocked, the keyboard stays locked until an 
extension character request is completed. 


When the cursor is moved to home position by CC2, the 5494 places the cursor at 
the designated home position. However, if an input field has a shift-out character in 
the first field position and the home position is defined as position 1, 2, or 3, the 
cursor will be moved to position 2. 


The 5494 leaves the cursor under a shift control character in an open field if that 
character is in the home position and is not in one of the first three positions. 


If control character 1 (CC1) specifies write nulls to nonbypass input fields, the 5494 
inserts nulls in the ideographic input fields as follows: 


Ideographic only: The 5494 inserts nulls in all field positions between shift 
control characters. The Shift control characters are not changed. 


Ideographic data type: The 5494 inserts nulls in all field positions. 


Ideographic either (Ideographic mode): Same as ideographic only input 
field. 


Ideographic either (Alphanumeric mode): The 5494 inserts nulls in all field 
positions from leading attribute to trailing attribute. 


Ideographic open: The 5494 inserts nulls in all field positions from the 
leading attribute to the trailing attribute, regardless of shift control characters in 
the field. 


Start of Field Order: The start of field order may be used to define ideographic 
input fields. There is an ideographic field control word to define the type of field. 


Field Control Word: The ideographic field control word (FCW) is a subfield that 
defines the specific ideographic field types. The ideographic FCW value is X'82' 

in the high-order byte. The low-order byte defines the ideographic field as shown in 
Table. A-1. 


Table A-1. Ideographic Field Definition for Low-Order Byte 
Bits Binary Description 


0-2 Ideographic field type 
000 = Ideographic only field 
001 = Ideographic data type 
010 = Ideographic either field 
100 = Ideographic open field 


3-7 Reserved 
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Ideographic Field Types: The ideographic FCW defines four ideographic field 
types: 


Ideographic only An input-capable field that contains only double-byte data, 
(shift-in and shift-out characters are within the input field). 


Ideographic data type An input-capable field that contains only double-byte data, 
(shift-in and shift-out characters are ideographic extended 
attributes and are not within the input field). 


Ideographic either An input-capable field that contains either double-byte or 
single-byte data with selection made at entry time. 


Ideographic open An input-capable or output field that contains a mixture of 
single-byte and double-byte data with shift-out (SO) and 
shift-in (SI) characters marking the transitions. 


General Ideographic Field Information: \deographic input fields are valid for all 
ideographic displays, regardless of the attached keyboard type. However, 
ideographic input fields appear as alphanumeric input fields on alphanumeric 
displays. 


Additional restrictions in field length for ideographic input fields are: 
e The field length must include shift control characters. 


e The minimum field length for all ideographic input fields except ideographic 
data type is 4 bytes; space for at least 1 double-byte ideographic character 
must be between the required shift control characters. The minimum field 
length for ideographic data type is 2 bytes; space for at least one double-byte 
ideographic character. 


e An even value must be specified for the field length of ideographic only, 
ideographic data type and ideographic either fields, because all double-byte 
characters require 2 bytes and may be enclosed by a pair of shift control 
characters. 


¢ The field length may not be specified past the end of the display (the field will 
not wrap to the top of the display). 


Any data stream that does not follow these restrictions is rejected with a negative 
response. 


The AS/400 system can write data anywhere on the display. However, the AS/400 
system program: 


¢ Should maintain shift control character pairs and spacing with an even number 
of positions between shift control characters. Keyboard operations are 
unpredictable when shift control characters are misplaced or not paired. 


e Should not include attribute characters between shift control characters. 
Attribute characters act like shift-in characters and switch the display into 
Alphanumeric mode. 


¢ Must know that the operator can change data in ideographic input fields. 
Note: The 5494 does not examine data written by the AS/400 system when 
processing keystrokes in ideographic input fields. 


The start of field (SF) order does not cause nulls to be inserted in the input fields. 
Displayed data is not changed unless it is written over by a screen attribute or shift 
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control character. Displayed data from a previous operation can determine the 
mode of a field or can be displayed in an incorrect mode unless you are aware of 
the previous operation. 


Ail data following an SF order is placed one position past the field start attribute. If 
double-byte data follows an SF order, the AS/400 system must ensure correct 
positioning of shift characters. 


Ideographic Only Fields: For ideographic only fields, the 5494 writes the 
following, in order, on the display: 


1. A leading attribute (determines how the character is displayed) 


2. A leading shift-out character (X ‘OE’—indicates the start of a double-byte 
character string) 


3. A trailing shift-in character (X ‘OF’—indicates the end of a double-byte character 
string) 


4. A trailing attribute (determines how the next character is displayed). 


The 5494 pointer determines the starting location for data or orders that follow the 
SF order in the data stream. The pointer points to the location immediately to the 
right of the leading attribute (the location of the SO character). The SO character 
can be overwritten unless the pointer is modified by the set buffer address (SBA) 
order. 


Ideographic Data Type: \deographic data type fields require a display that 
supports ideographic extended attributes. These extended attributes are written to 
the extended attribute buffer and do not occupy a screen position. 


Ifa WRITE TO DISPLAY command, Start of Field order, contains an Ideographic 
Data Type FCW and the display does not have extended ideographic attribute 
capability, the data stream is rejected with a negative response. 


ldeographic data type fields can contain only two-byte ideographic characters. 
When an ideographic data type field is defined on an ideographic display, the 5494 
writes a leading attribute and a leading SO attribute behind the first field position. 
An SI attribute is written behind the first byte beyond the last field position. If an 
ideographic data type field is written to a non-ideographic display, the FCW is 
ignored and no SO or SI attributes are written. 


If an ideographic data type field occupies more than one line, the 5494 assumes 
that the AS/400 system has positioned the field such that a double byte of data is 
not split between lines. 


The internal 5494 pointer points to the first field position as the starting location for 
data. This pointer may be modified by a set buffer address (SBA) order. 


Ideographic Either Fields: The operator can change field modes only when the 
cursor is under the first enterable character position of the field. When the field 
mode is changed from Alphanumeric to Ideographic, the 5494: 


1. Nulls the entire field between leading and trailing attributes. 


2. Writes an SO character in the position immediately following the leading 
attribute. 
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3. Writes an SI character in the position immediately preceding the leading 
attribute. 


4. Places the cursor in the position immediately following the SO character. The 
cursor blinks and occupies two screen positions to indicate Ideographic mode. 


5. Sets MDT in the field format word. 


6. Sets the appropriate entry mode. Alphanumeric keyboards are set to Alternate 
Entry mode to allow you to enter characters with alternate character numbers 
or by double-byte direct entry. 


When the field mode is changed from Ideographic to Alphanumeric, the 5494: 
1. Nulls the entire field between leading and trailing attributes. 


2. Places the cursor in the position immediately following the leading attribute. 
The cursor blinks and occupies one screen position to indicate Alphanumeric 
mode. 


3. Sets MDT in the field format word. 


4. Sets the keyboard to Alphanumeric mode for all keyboard types. 


When the AS/400 system defines an ideographic either field, the 5494 writes a 
leading attribute and a trailing attribute on the display. Shift control characters are 
not written on the display; therefore, the field is initially alphanumeric. The AS/400 
system can write shift control characters into the fields. 


For an ideographic either field, write the shift-out character only in the position 
immediately following the leading attribute. 


Ideographic Open Fields: After processing the SF order defining an ideographic 
open field, the 5494 address pointer points to the location immediately to the right 

of the leading attribute. The AS/400 system can write shift characters into the field 
provided that: 


e Each SO character is followed by a closing SI character. 


e An even number of screen positions exists between the SO and SI pair. 
Adjacent SO/SI or SI/SO pairs are allowed. 


e The first shift character in the field is an SO, and SO and SI characters 
alternate. Consecutive SO or Si characters are not allowed. 


When the AS/400 system defines an open field, the 5494 writes a leading attribute 
and a trailing attribute on the display. Shift control characters are not written on the 
display; therefore, the field is initially alphanumeric. The AS/400 system can write 
shift control characters into the fields. 


Field Format Word: Table A-2 on page A-10 identifies the fields and their 
characteristics for the ideographic field format word (FFW). 


The information in parentheses immediately following the field type gives the byte 
and bit identifiers of the field and the FFW. 
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Table A-2. FFW Field Types and Characteristics 


Field Type 


Alphabetic shift 
(byte 1, bits 5-7 = 000) 


Auto enter (byte 2, bit 0) 


Dup enable (byte 1, bit 3) 


Modify data tag (byte 1, bit 4) 


Field exit required 
(byte 2, bit 1) 


Mandatory enter (byte 2, bit 4) | 


Mandatory fill (MF) 
(byte 2, bits 5-7 = 111) 


Monocase (byte 2, bit 2) 


Right adjust 
(byte 2, bits 5-7 = 110-blank) 
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Description 


Must be 000 if an ideographic FCW is present; otherwise, the ideographic FCW is 
ignored. | 


For ideographic only and either fields, the last character of the field is the 
double-byte character before the shift-in character. The last double-byte character 
causes auto enter to occur. For ideographic open fields, auto enter occurs when 
the last enterable position of the field is filled. 


Allows the operator to press the Dup key to exit an ideographic only or an | 
ideographic either field, leaving the field filled with double-byte Dup characters. 
The characters fill the space above the current cursor position through the end of 
the field. The shift control characters are not duplicated. Dup enable is valid for 
an open field if the cursor is located in the first enterable position of the field; 
otherwise, an error occurs. The result of Dup in an open field is that all positions 
will contain the Dup symbol. 


This bit is set in an ideographic either field when the operator changes the field 
mode since this adds or deletes SO and SI characters in the field. Therefore, it is 
possible to send a field of all nulls to the AS/400 system by changing field mode. 
Modify data tag (MDT) is set in ideographic open fields when subfields are 
inserted or deleted. The following keys also cause MDT to be set: 


e Alternate Enter (if a valid code is entered and written to the screen) 


e Ideographic Shift/Data key combinations that cause data to be written to the 
screen 


e Valid Repeat key operations (even if a null is written) 
¢ Erase to End of Field (even if a null is written). 


MDT is not set by pressing the Mode keys alone or by pressing a Command/Mode 
key sequence if the field mode is not changed, or if SO/SI are not inserted. 


For an ideographic field, moving the cursor one or two positions to the right does 
not make the cursor leave the field. If you move the cursor one position 
(single-wide cursor under the right half of the last character), you can type in the 
last character again. 


Field exit required should not be specified for ideographic open fields. 


For ideographic either fields, switching field mode sets the modify data tag (MDT) 
bit and meets the mandatory enter requirement. Inserting or taking out an open 
field or subfield also sets the MDT bit and meets the mandatory enter requirement. 


Mandatory fill is set when an ideographic character is entered in an ideographic 
only or either field. This field is also set in an ideographic either field that has a 
changed mode (shift control characters are either added or taken out of the 


_ Original field). This field is also set by ideographic open fields when double-byte 


or single-byte characters are entered, or a subfield is added or taken out. The 
field requirements are tested between the leading and trailing shift control 
characters in ideographic only and either fields. In ideographic open fields, testing 
is done from field start to field end. 


This bit is ignored for Japanese ideographic systems. 


In ideographic only and either fields, the data is right-adjusted to the ending 
shift-in character. X'4040' fills the null character positions to the left of the 
adjusted data. Zero fill should not be specified; blanks occur. 


This function is not used in ideographic open fields and should not be specified. 


Format Level 0: Initially, the field is set for alphanumeric entry. You can select 
ldeographic mode by pressing the Kanji key. Successive depressions of the Kanji 
key will alternately select |deographic or Alphanumeric mode. When you select 
ldeographic mode, a shift-out character is written into the second position of the 
screen buffer (row 1, column 2) and a shift-in character is written into the last 
position (the last row, column 79). Screen attributes occupy the first and last 
positions on the display. 


In Free Key mode, fields are initialized for alphanumeric entry. You can press any 
key that does not require AS/400 system action in Free Key mode. If you press a 
key that requires AS/400 system program action, system reference code 0099 is 
displayed. 


Format level O for the 5494 has the following specific definition: 


e The FFW is alpha shift and has an ideographic either FCW. 


¢ No shift control characters are written on the display. The ideographic either 
field is initialized as an alphanumeric field. This allows alphanumeric entry. 


e The input field starts at row 1, column 2, and ends in the last row, column 79. 
The field length is equal to the screen size, less 2 bytes. (Two bytes are used 
for screen attributes.) 


e The leading attribute is set in row 1, column 1, and the trailing attribute is set in 
the last row, column 80. 


e The cursor is initially set to row 1, column 2, and is blinking. 
e The keyboard is set to Alphanumeric mode with auto-shift active. 
e The 5494 translates any single-byte keystrokes while in Alphanumeric mode. 


e The Kanji key causes the field to change to Ideographic mode. 


Ideographic entry is forced in Ideographic mode, but no extension character 
requests are sent to the AS/400 system because the workstation is not 
communicating with the AS/400 system. The valid ideographic code for the 
extension character is written into the workstation buffer, but special default 
characters are displayed. 


On ideographic displays, at Format Level 0, the following function keys are added 
to the valid function keys in Free Key: mode: 


¢ Display OE/OF Character 
e Erase End of Field 

e Kanji 

e Character Advance. 


AS/400 System Extended Ideographic Support 


The AS/400 system sends the extended double-byte character data to the 5494 
when: 


e The AS/400 system recognizes a character in the outbound data stream that is 
an extended double-byte character and the definition of the bit matrix is 
required at the workstation. 


e The workstation operator requests an extended double-byte character by typing 
in an input field. 
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LOAD MATRIX Command Definition 


The LOAD MATRIX command loads the bit matrix into the RAM of an ideographic 
workstation or identifies the RAM location that already contains the bit matrix for a 
double-byte character. The command format is shown in Table A-3. | 


Table A-3. Load Matrix Command Format 


Value 

Byte (Hex) Description 

0 04 Escape character 

1 31 LOAD MATRIX command 

2-3 YYYY Extension character whose bit matrix is being loaded, or is 
already loaded 

4—5 AAAA Display RAM address 

6 nn Length of the bit matrix data included with this command. 
The length does not include this byte. 

7-n DDDD Bit matrix data (optional) 


Valid decimal values for byte 6 are: 


e O—No bit matrix is included, the display RAM address contains the bit matrix 
pattern 

e 72 — 24 x 24 bit matrix is included 

e 116 — 116-byte 26 x 29 bit matrix is included. 


lf the length value is not valid (0, 72, or 116), the data stream is rejected with a 
parameter error SNA negative response X'1005012E'. 


Valid extension character RAM addresses are: 
e X'F040' through X'FOFF' 


e X'F140' through X'F1FF' 
e X'F240' through X'F2BF'. 


lf the workstation does not support the RAM address, the data stream is rejected 
with a parameter error SNA negative response X'1005012E'. 


LOAD MATRIX Command Processing 
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The AS/400 system searches all data streams for extension characters before 
sending the data streams to the 5494. Each extension character code point is 
replaced by a RAM address assigned by the AS/400 system, which contains the bit 
matrix. The AS/400 system issues the LOAD MATRIX command to the 5494 to 
load the bit matrix for each assigned RAM address. 


The AS/400 system maintains a RAM content list as the data streams are searched 
for extension characters. The AS/400 system issues a LOAD MATRIX command 
for each extension character in the data stream. At the end of the data stream, the 
RAM content list matches the contents of the extension character RAM inthe 
noe 


LOAD MATRIX commands can be included with any data stream that is sent to the 
workstation. It is recommended that the LOAD MATRIX command precede the 
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WRITE TO DISPLAY command so that the extension characters are immediately 
displayed when the RAM addresses are written into the workstation buffer. 


lf a workstation operator enters an alternate or user-defined character that is not in 
the character-generating ROS in the workstation, the 5494 sends an extension 
character request to the AS/400 system. 


The 5494 waits fora LOAD MATRIX command with a matching ideographic code 
point. The extension character request is satisfied when the 5494 receives the 
matching LOAD MATRIX command from the AS/400 system. The keyboard is 
locked and the cursor stays in the same position while the AS/400 system 
processes the extension character request. 


The extension character request can be cleared and the keyboard unlocked by one 
of the following commands: 


e CLEAR FORMAT TABLE 
e CLEAR UNIT 

e WRITE ERROR CODE 

e WRITE TO DISPLAY. 


The following sequence is used to process the LOAD MATRIX command: 


1. When the 5494 receives a LOAD MATRIX command, the length byte is tested 
to make sure that the command is valid. If the length byte is valid and is not 0, 
the 5494 loads the bit matrix into the extension character RAM at the assigned 
address. If the length is 0 (meaning that the bit matrix is already loaded), the 
RAM is not loaded. 


2. The 5494 tests for a locked keyboard while processing the extension character 
request. 


When the keyboard is locked, an extension character request LUSTAT has 
been sent to the AS/400 system and the workstation is waiting for the AS/400 
system to respond. The 5494 compares the double-byte ideographic code from 
the AS/400 system to the extension character code sent to the AS/400 system. 
lf the two codes match, the 5494 writes the RAM address on the screen at the 
current cursor position and unlocks the keyboard. If the two codes do not 
match, the 5494 does not write the RAM address on the screen and the 
keyboard stays locked while waiting for the correct LOAD MATRIX command. 


If the 5494 receives a LOAD MATRIX command when it did not send an 
extension character request, it loads the bit matrix into the extension character 
RAM, but does not write the RAM address on the screen. 


After the LOAD MATRIX command is completed, the 5494 starts on the next 
command in the data stream, if there is another command. 


Keyboard Functions 


The Ideographic support modifies the following key functions. For more information 
on key functions, see Chapter 16, “Keyboard Functions.” 


The AlD-generating keys generate AID codes that go in the display data stream to 
the AS/400 system in response to the READ commands. The AlD-generating keys 
that alert the AS/400 system that the 5494 requires some action are the command 
keys and the record backspace key. 
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Command Keys 


The command keys do special functions such as program function (PF). All 
keyboard modes use the same PF keys. 


Record Backspace Key 
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On the Ideographic keyboard, the record backspace function is the lower-shift 
function of the Erase Input/Home key. 


Normally, the 5494 recognizes only the designated home position. If the cursor is 
not at the home position when the Home key is pressed, the cursor is moved to the 
designated home position without any AID code sent to the AS/400 system. If the 
cursor is already at the home position when the Home key is pressed, the 5494 
sends a record backspace AID code to the AS/400 system without moving the 
cursor. 


The home position is usually the first position of an input field. However, the first 
character for an ideographic input field may or may not contain a shift-out 
character. If the home position falls under a leading shift-out character, the 5494 
assumes a home position at the first character position of the input field. 


For more information on character entry, refer to your workstation documentation. 
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| Appendix B. Unsupported 5250 Data Stream Commands 


The 5250 data stream architecture includes the True Transparency Write 
Command. This command is not supported by the 5494. 


True Transparency Write Command 


The True Transparency Write command enables an AS/400 application to send 
transparent data to a target device. Currently, this command is designed only to 
pass ASCIl data to some type of ASCII device. The 5494 does not support this 
command. 


Note: Support for this command can be determined from Query Reply Byte 18/Bit 
q. 


The data written with this command is generally not written to the 5250 display 
screen. This command has no effect on 5250 keyboard state or 5250 cursor 
position. 


The True Transparency Write command must follow an Escape/Write Single 
Structured Field Command (X'04F4'). 


Note: A single structured field command follows a Write Single Structured Field 
Command. Other 5250 Display Data Stream commands and orders can precede 
or follow the True Transparency Write command. A 5250 Display Data Stream can 
contain multiple True Transparency Write commands. If an additional data stream 
command or order follows the True Transparency Write command, the following . 
data stream must begin with an Escape character (X'04'). 


Note: The True Transparency Write command is unrelated to the Transparent 
Data order and Transparent entry field FCW. 


True Transparency Write Major Structure 


Table B-1. Format of True Transparency Write Command—Major Structure 


Byte Name Value Description 
1-2 Major Length >5 Total length of major structure, 
including the length bytes. 
3 Class X'D9' 5250 structured field command 
) class 
4 Type X'6A' True Transparency Write type 
5 Flag byte 
X'00' Invalid 
X'01' ASCII data if set on. Bytes 6—n of 


this command will be sent to the 
target ASCII device without any 
EBCDIC to ASCII translation. 
X'02'-X'FF' Reserved 
6-n Transparent data 
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Glossary 


Numerics 


10BASE2. IEEE standard for a baseband Ethernet 
operating at 10 Mbps and using thin coaxial cable with 
a maximum length per segment of 200 m (656 ft). 
Synonymous with thin Ethernet. 


10BASE5. IEEE standard for a baseband Ethernet 
operating at 10 Mbps and using thick coaxial cable with 
a maximum length per segment of 500 m (1640 ft). 
Synonymous with thick Ethernet. 


10BASE-T. IEEE standard for a baseband Ethernet 
operating at 10 Mbps and using unshielded twisted-pair 


cable with a maximum length per segment of 100 m 
(328 ft). 


A. Address (A). 

ABM. Asynchronous balanced mode. 

ACTLU. Activate logical unit. 

ACTPU. Activate physical unit. 

adjacent link station (ALS). A link station that directly 
connects a given node by a link connection, over which 
network traffic can be carried. 

ADM. Asynchronous disconnected mode. 

AID. Attention identifier. 

alert. For LAN management-based products, a 
notification indicating a possible security violation, a 
persistent error condition, or an interruption or potential 
interruption in the flow of data around the network. 
ALS. Adjacent link station. 

alternate host. When the 5494 is configured to use 
concurrent host attachment, an alternate host is an 


AS/400 system that is not the primary host. 


analog network. A type of communications network 
that carries analog signals. 


API. Application program interface. 
ARM. Asynchronous response mode. 


AS/400 system. In a communications system, the 
computer that provides end-users with services such as 
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computation and databases, and that usually does 
network control functions. 


AS/400 system operator. A person who uses the 
workstation that is designated as the system console to 
activate certain system functions, and to control and 
monitor system operation. 


ASCII. American National Standard Code for 
Information Interchange. 


ASM. Address space manager. 


asynchronous balanced mode (ABM). An 
operational mode of a balanced data link in which either 
combined station can send commands at any time and 
can initiate transmission of response frames without 
explicit asynchronous response permission from the 
other combined station. 


asynchronous data transfer. A physical transfer of 
data that occurs without a regular or predictable time 
relationship. Start and stop bits are required to indicate 
transmission boundaries. 


asynchronous response mode (ARM). An 
operational mode of an unbalanced data link in which a 
secondary station may initiate transmission without 
explicit permission from the primary station. 


attention identifier (AID). A character in the 
identification string indicating that the user has pressed 
a key, such as the Enter key, that requests an action by 
the system. 


Attn. Attention. 


AWG. American Wire Gauge. 


B' '. Binary number in single quotes. 


basic information unit (BIU). In SNA, the unit of data 
and control information passed between half-sessions. 
It consists of a request/response header (RH) followed 
by a request/response unit (RU). 


basic link unit (BLU). In SNA, the unit of data and 
control information transmitted over a link by data link 
control. 


BBI. Begin bracket indicator. 
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beacon. In the Token-Ring network, a frame sent by 
an adapter indicating a serious network problem, such 
as a broken cable. 

beaconing. Sending beacon frames continuously. 
BEL. The bell character. 

BIDI. Bidirectional. 

BIS. Bracket initiation stop. 

BIU. Basic information unit. 

BLU. Basic link unit. 

bps. Bits per second. 

BTU. Basic transmission unit. 

buffer. A temporary storage location, especially one 


that accepts information at one rate and delivers it at 
another rate. 


C 


cache. A storage area within a workstation for 
image/fax data. 


CAT. Request/response unit category. 
C. Control field. 


cable-through. A method of cabling that allows 
multiple workstations to be attached to a single cable 
path. 


cabling system. A system of communications wiring 
installed in a building to connect computers and 
communications equipment. 


CC. Control character. 


CCITT. International Telegraph and Telephone 
Consultative Committee. This was an organization of 
the International Telecommunication Union (ITU). On 1 
March 1993 the ITU was reorganized, and 
responsibilities for standardization were placed in a 
subordinate organization named the Telecommunication 
Standardization Sector of the International 
Telecommunication Union (ITU-TS). “CCITT” continues 
to be used for recommendations that were approved 
before the reorganization. 


CD. Change of direction. 
CDI. Change direction indicator. 
CDSTL. Connect data set to line. 


CGCS. Character graphics code set. 
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Cl. Calling indicator. 


closed user group. A group of locations that can 
communicate themselves, but cannot call, or receive 
calls from, any location outside the group. This facility 
allows a limited number of users to communicate with 
either the 5494 or the AS/400 system, and thus 
increases security. You can usually obtain this service 
at a nominal fee, or it may be provided as a basic 
service with your subscription. On some networks, you 
can specify different closed user groups for different 
applications, if your subscription includes more than one 
group and a closed user group index is included in the 
connection setup instructions. Variations that allow 
calls to or from a device outside the group may be 
available depending on the network. 


Cmd. Command. 

CNM. Communication network management. 
CNOS. Change number of sessions. 

CNR. Controlled-not-ready. 

coaxial cable. A cable consisting of one conductor, 
usually a small copper tube or wire, within and insulated — 
from another conductor of larger diameter, usually 


copper tubing or copper braid. 


code. A set of instructions for a processing unit 
located in memory. 


common carrier. In the U.S.A., a 
government-regulated private company (such as a 
telephone or telegraph company) that furnishes the 
general public with telecommunications service facilities. 
concurrent host attachment. A function that enables 
the 5494 to communicate with one to four AS/400s over 
a single physical link. 


copy and paste. An operation using a mouse that 
copies text from one area of a screen to another. 


cpi. Characters per inch. 

CPS. Cail progress signal. 

CR. Carriage return. | 

CRC. Cyclic redundancy check. 


CRD. Call request command with double dial-up 
required. 


CRI. Call request command with number and 
identification provided. 


CRN. Call request command with number provided. 


CRS. Call request command with memory address 
provided. 


CSI. Code selection indicator. 
CSU. Customer setup. 

CTS. Clear to send. 

CU. Clear unit. 


customer setup (CSU). The unpacking, assembly, 
connecting, and checkout of IBM CSU-designated 
machines by user personnel according to a sequence of 
instructions provided by IBM. CSU is done without the 
use of tools and without help from IBM personnel. 


cyclic redundancy check (CRC). A mathematical 
process that determines the accuracy of a specific field 
or fields of data in an SDLC frame. 


D 


DACTLU. Deactivate logical unit. 
DAF. Destination address field. 


data circuit-terminating equipment (DCE). The 
equipment that provides the signal conversion and 
coding between the data terminal equipment (DTE) and 
the line. 


data coupler. An electrical isolation device usually 
required by a common carrier to attach to the carrier's 
switched telephone lines. This is also referred to as a 
data access arrangement or protective coupler. 


data link connection identifier (DLCl). A numeric 
identifier that is used in a frame-relay network to identify 
the next segment of a permanent virtual circuit over 
which a frame is to be relayed. 


data packet. The type of data grouping used to send 
information from one DTE to another DTE attached to 
an X.25 packet switched network. 

data terminal equipment (DTE). A term for any 
machine, such as the 5494 or the AS/400 system, that 
is connected to a network. 

Db. Decibel. 

DBCS. Double-byte character set. 

DCD. Data carrier detect. 

DCE. Data circuit-terminating equipment. 

definite response. In SNA, a value in the 


form-of-response-requested field of the request header. 
The value directs the receiver of the request to return a 


response unconditionally, whether positive or negative, 
to that request. 


Del. Delete. 


dependent workstation (DWS). See 
nonprogrammable workstation (NWS). 


DFC. Data flow control. 


Diacritic. A mark added to a letter to indicate a special 
phonetic value. 


direct attachment. Attachment of workstations to an 
AS/400 system without intermediate control units. 


diacritic. A mark added to a letter to indicate a special 
phonetic value. 


DISC. Disconnect command. 
display screen. The presentation surface of a cathode 
ray tube used to display graphics or alphanumeric 


information. 


display station. An input/output device containing a 
display screen and an attached keyboard. 


DIX. Digital, Intel, Xerox. 
DLC. Data link control. 
DLCI. Data link connection identifier. 
DM. Disconnect mode. 

DMA. Direct memory access. 

DP. Data processing. 

DR. Data ring. 

DR1I. Definite response 1 indicator. 
DR2!. Definite response 2 indicator. 
DRAM. Dynamic random access memory. 
DSP. Data stream profile. 

DSR. Data set ready. 

DSRS. Data signal rate select. 

DSU. Digital service unit. 

DTE. Data terminal equipment. 


DTR. Data terminal ready. 


dual connection. An SVC and a PVC operating on 
the same physical X.25 DTE/DCE interface. 
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Dup. Duplicate. 


duplex. A method of data transmission in which the 
data can be transmitted in both directions 
simultaneously. (Also known as full-duplex.) 


DWS. Dependent workstation. See nonprogrammable 
workstation (NWS). 


DXE. Data transmit enable. 


E 


EA. Erase to address. 
EAB. Extended attribute buffer. 


EasyScroll. Scrolling of image/fax data within a 
workstation. This is done by one of two methods: 


1. Press the primary mouse button and move the 
mouse pointer. 

2. Press both the alt key and the primary mouse 
button and move the mouse pointer. 


As the mouse pointer moves, the image within the 
viewport is scrolled. The mouse pointer may be 
anywhere on the screen. 

EB. End bracket. 


EBCDIC. Extended binary-coded decimal interchange 
code. 


EBI. End bracket indicator. 

ECB. Extended character buffer. 

EDI. Enciphered data indicator 

EIA. Electronics Industries Association. 

ELLC. Enhanced logical link control. 

emulation. The imitation of all or part of one system 
by another (primarily by hardware) so that the imitating 
system accepts the same data, runs the same 
programs, and achieves the same results as the 


imitated system. 


enhanced logical link control. A type of logical link 
control used in X.25 communications. 


EOC. End of chain. 

EOF. End of field. 

EOM. End of message. 

EOQ. End-of-command queue. 


EOT. End-of-tape marker. 
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ERAP. Error recording analysis procedure. 
ERI. Exception response indicator. 

ERP. Error recovery procedure. 

ESC. Escape character. 


Ethernet. A 10-Mbps baseband local area network 
that allows multiple stations to access the transmission 
medium at will without prior coordination, avoids 
contention by using carrier sense and deference, and 
resolves contention by using collision detection and 
delayed retransmission. Ethernet uses carrier sense 
multiple access with collision detection (CSMA/CD). 


exception response (EXR). In SNA, a value in the 
form-of-response-requested field of a request header. 
The receiver is requested to return a response only if 
the request is unacceptable as received or cannot be 
processed (that is, a negative response can be 
returned). 


EXR. Exception response 


F 
F. Flag. 


FCS. Frame check sequence. 


FCW. Field control word. 


- FER. Field exit required. 


FF. Form feed indicator. 

FFW. Field format word. 

FI. Format indicator. 

FIC. First in chain. 

FID. Format identification. 

field replaceable unit (FRU). An assembly that is 
replaced in its entirety when any one of its components 


fails. 


flag. A logical tool used to differentiate between two 
different states. 


flow control negotiation. The ability to alter the 
packet size and packet window size. These may be 
changed from call to call if the network subscription 
allows flow control negotiation. 


FM. Function management. 


FMD. Function management data. 


FMDS. Functional management data services. 
FMH. Function management header. 


format identification (FID). In SNA, a field in each 
transmission header (TH) that indicates the format of 
the transmission header (that is, the presence or 
absence of certain fields). 


frame. A single transmission of variable length (32-bit 
minimum format) that SDLC uses for transmission of 
data over a communications network. 


frame handler (FH). A router function that uses the 
address field in a frame-relay frame. 


frame relay. An interface standard describing the 
boundary between a user’s equipment and a fast-packet 
network. In frame-relay systems, flawed frames are 
discarded; recovery comes end-to-end rather than 
hop-by-hop. 


frequency shift keying (FSK). The frequency 
modulation of a carrier by a digital modulating signal. 


FRMR. Frame reject. 

FRU. Field replaceable unit. 

FSK. Frequency shift keying. 

GDDM. Graphical Data Display Manager. 
GFI. General format identifier. 

Group 3 fax. 
(modified read)/two-dimensional (modified read) coding 
scheme. 


Group 4 fax. CCITT T.6 G4 facsimile two-dimensional 
coding scheme. 


GUI. Graphical user interface. Displays with graphical 
user interface support include the 3486, 3487, and 
3488. They have special characters to draw boxes, 
menus, and scroll bars. 


H 


half-duplex. A method of data transmission in which 
data can be transmitted in both directions, but not at the 
same time. 


hard error (HE). An error condition on a network that 

requires the network be reconfigured or that the source 
of the error be removed before the network can resume 
reliable operation. 


CCITT T.4 G3 facsimile one-dimensional - 


HDLC. High-level data link control. 
HDX-FF. Half-duplex flip-flop. 
HE. Hard error. 


header. A prefix or preface that describes the type of 
information, and sometimes the quantity of information, 
that follows. The control field of the SDLC frame 
contains 5 bytes of SNA header information. 


help line. A line on a workstation screen that provides 
messages to the operator in symbols. For example, a 
clock indicates the operator must wait. 


hexadecimal. A number system with a base of 16. 
(Valid digits range from O through F.) 


hot spots. Screen data that is interpreted by the 5494 
to represent certain activities when a mouse cursor is 
positioned on the data and a button is clicked, or double 
clicked. For example, if you position the mouse cursor 
on the text F3 (Exit) and press the left mouse button, 
the 5494 translates that activity into the F3 key being 
pressed and sends the appropriate AID information to 
the AS/400 system. 


Hz. Hertz. 


|. Information. 
IA5. International Alphabet No.5. 


IBM Cabling System. A system of IBM-manufactured 
communication wiring that provides a common cable 
and connector type for a wide variety or wire types 
(such as coaxial, twinaxial, and telephone twisted-pair). 
Compare with twinaxial cable and telephone twisted-pair 
(TTP) cable. 


Note: It is used to pass information between devices 


separated by up to 1524 m (5000 ft.). 
IC. Insert cursor. 
ID. Identifier. 
ideographic. Used to identify processing performed by 
languages that require both single bytes and double 
bytes to represent their character sets. 
Information transfer format. 


l-format. 


independent workstation (IWS). See programmable 
workstation (PWS). 


initialization. A process that prepares for the 
beginning of another process. 
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initialization mode. A nonoperational mode of a 
balanced or unbalanced data link in which a remote 
secondary or combined station data link control program 
can be initialized or regenerated by the local primary or 
combined station, or in which other parameters to be 
used in the operational mode can be exchanged. 


interface. A shared boundary between two functional 
units, defined by functional characteristics, common 
physical interconnections, and signal characteristics. 
VO. Input/output. 


IOCA. Image Object Content Architecture (IBM). Refer 
to IOCA Reference, SC31-6805. 

IPDS. Intelligent printer data stream. 

IPDU. Information protocol data unit. 
IPL. Initial program load. 
ISO. International Organization for Standardization. 


IWS. See programmable workstation. 


KB. Kilobyte. 
keyboard translation table (KTT). A translate table 
downloaded from an AS/400 system during the 
power-on process of a device. The new table replaces 
the default keyboard translate table of the device. See 
translate table. 
KTT. Keyboard Translation Table. 
LAC. Load alternate characters. 
LAPB. Link access protocol-balanced. 
LCI. Logical channel identifier. 
leased line. A communication line that is permanently 
connected, always available, and does not require 
dialing to establish communication. Synonymous with 
nonswitched line. 
LEN. Low-entry networking. 


LF. Line feed character. 


LFSID. Local form session identifiers. 
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LIC. Last in chain. 


line turnaround. Time required to change the 
direction of transmission (from send to receive) a 
half-duplex circuit. 


link access protocol-balanced (LAPB). A protocol 
used for accessing an X.25 network at the link level. 
LAPB is a duplex, asynchronous, symmetric protocol 
used in point-to-point communication. 


link management interface (LMI). The interface over 
which status messages are exchanged between two 
points in a frame-relay network. 


link window size. The maximum number of I-frames 
that can be sent from the 5494 without receiving an 
acknowledgment from the network. Valid values are 1 
through 7. 


LL. Local loopback. 
LLC. Logical link control. 
LMI. Link management interface. 

lobe. Jn a Token-Ring network, the section of cable 
(which may consist of several cable segments) that 
connects an attaching device to an access unit. 


local loopback. A test procedure done to verify the 
operation of the local modem. 


logical link control. Information included in data 
packets for X.25 that provides end-to-end link-level type 
functions to the SNA layers in the AS/400 system and 
the 5494. 

logical unit (LU). In SNA, a port through which an 
end-user accesses the SNA network in order to 
communicate with another end-user, and through which 
the end-user accesses the functions provided by system 
services control points (SSCPs). 

LP. Licensed program. 

LPDU. Logical protocol data unit. 

Ipi. Lines per inch. 

LSID. Local session identifier. 

LU. Logical unit. 

LU 6.2. Logical unit 6.2. 


LUSTAT. Logical unit status. 


MAC. Medium access control. 
MSAU. Multistation access unit. 


maintenance analysis procedure (MAP). A 
maintenance document that gives an IBM service 
representative a step-by-step procedure for tracing a 
symptom to the cause of failure. 


mandatory enter (ME) field. A field in which a user 
must enter at least 1 character. 


mandatory fill (MF) field. A field a user must fill 
completely or leave blank. 


MAP. Maintenance analysis procedure. 
MC. Move cursor. 

MDT. Modified data tag. 

ME. Mandatory enter. 

MF. Mandatory fill. 

MI. Mode indicate. 

MIC. Middle in Chain. 


migration. The process of changing to a new 
operating environment, usually to a new release or 
version of a system. 


modem (modulator-demodulator). A device that 
converts digital data from a computer to an analog 
signal that can be transmitted on a telecommunication 
line and converts the analog signal received to data for 
the computer. 


modulo. In a sequence of numbers, the modulo 
number indicates the point at which the sequence 
returns to 0. For example, modulo 8=012345670123... 


mouse. A type of pointer device attached to a display. 


MPL. Maximum print line. 
MPP. Maximum print position. 
MPU. Microprocessing unit. 
MSR. Magnetic stripe reader. 


multipoint line. A data link that connects three or 
more data stations. A multipoint line is always leased. 


N 


NAU. Network addressable unit. 

NC. Network control. 

NCI. Network control information. 

NCP. Network control point. 

NDM. Normal Disconnected mode. 

NEMA. National Electrical Manufacturer's Association. 
network addressable unit (NAU). In SNA, a logical 
unit, a physical unit, or a system services control point. 
The NAU is the origin or the destination of information 
transmitted by the path control network. 

network architecture. A set of design principles, 
including the organization of functions and the 
description of data formats and procedures, for the 
purpose of allowing multiple computers to communicate 
so that they can share software and hardware. 

NL. New line character. 

NLS. National language support. 

NMVT. Network Management Vector Transport. 
nonprogrammable workstation (NWS). A workstation 
that is incapable of operating independently of the 5494 
or the AS/400 system. A PC or PS/2 computer running 
a 5250 emulation program is also considered a DWS by 
the 5494. 

nonreturn to zero. A data encoding method. 
nonreturn to zero inverted. A data encoding method. 
nonswitched line. See /eased line. 

no response. In SNA, a value in the 
form-of-response-requested field of the request header 
(RH) indicating that the no response is to be returned to 


the request, whether or not the request is received and 
processed successfully. 


Nr. Receive count. 

NRM. Normal Response mode. 
NRZ. Non-return-to-zero. 

NRZI. Non-return-to-zero inverted. 
NS. No network services. 


NSMV. Network services major vector. 
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Ns. Send count. 


NUI. Network user identification 


Nul. Null character. 


NWS. Nonprogrammable workstation. 
N2. Retry count. 


NS. Maximum in. 


O 


OAF. Origin address field. 


ODAI. Origin/destination address field assignor 
indicator. 


OIC. Only in chain. 


OR. A logic operator having the property that if Pis a 
statement, Q is a statement, R is a statement,...then the 
OR of R, Q, R....., is true if at least one statement is 
true, false if all statements are false. P OR Q is often 
represented by P + Q, PvQ. 


P/F. Poll final (bit). 


PA. Program access. 


pacing. A method by which a receiving station controls 
the rate of transmissions of a sending station. Ifa 
transmission is sent faster than it can be handled, a 
portion of the transmission would be lost. This is called 
overrun. 


PackBits. Image file run-length compression 
procedure (Macintosh). 


packet. Information transmitted through a packet 
switched network is divided up and inserted into 
packets. These usually consist of control information 
field giving destination, sequence number, optional 
facilities, and often a user data area. Various kinds of 
packets are used to transmit error codes and supervise 
the virtual circuit. 


packet size. The maximum number of bytes allowed 
in the user data area of a data packet. A default value, 
usually 128 bytes, is assigned at subscription time. On 
some networks, the packet size can be altered from call 
to call. 


packet switching. The transfer of data by means of 
addressed packets that occupy the network channel 
only during actual transmission. The channel is 
available for the simultaneous transfer of packets 
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belonging to other network users. The network 
determines the optimum routing of each individual 
packet during, rather than prior to, the transmission 
from a DTE. oo 


packet window size. Maximum number of packets 
that can be sent without receiving an acknowledgment. 


parity. A system to ensure that a byte was received as 
it was transmitted. In a system that uses “even” parity, 
with 7 bits plus a parity, if the sum of the first 7 bits is 
an odd number, a 1 would be put in the eighth bit to 
make sure the sum of all bits an even number. In “odd” 
parity, a O would be put in the eighth bit so that the sum 
of all bits would be an odd number. 


pass-through. Moving through a controller without 
modification. A pass-through data stream may have 
communications protocols changed but the data portion 
is not modified in any way. 


PC. Path control. 

PC/TV. A product of the TECMAR Corporation that 
provides cable-ready capability to a PS/2 personal 
computer user. The PC/TV unit is designed to be 
placed underneath or beside the PS/2 monitor. It 


supports 24-bit full-motion video and has a built-in 
speaker and headphone connector for audio output. 


PCX. PaintBrush format bit-mapped graphics. 
PDI. Padded data indicator. 

PDN. Public data network. 

PDT. Printer definition table. 

PF. Program function. 

permanent virtual circuit (PVC). The packet switched 
equivalent of a leased line. The 5494 and the AS/400 
system appear to the user to be permanently 


connected. 


physical services header (PSH). A type of logical link 
control used in X.25 communications. 


Pl. Pacing indicator. 
PIP. Picture in picture. See PC/TV. 
PIU. Path information unit. 


planar. The planar is a printed-circuit electronic board 
that contains the logic that directs the 5494. 


PLU. Primary logical unit. 


point-to-point line. A data link that interconnects two 
DTEs. It can be either switched or leased. 


polling. The method the AS/400 system or 5494 uses 
to ask a workstation if it wishes to transmit. 


POR. Power-on reset. 


port. The hardware coupling used to attach 
workstations to the 5494. 


Post Telephone and Telegraph Administration 
(PTT). A name used to describe a World Trade 
operating agency that controls the transportation of 
information (postal, voice, and/or data). 


power cord. A cord that plugs into a wall outlet 
supplying electrical power. 


primary host. The first host with which the 5494 
establishes a session. It is the host from which the 
5494 receives code corrections (AS/400 PTFs for the 
5494). 


Printer definition table (PDT). A translate table 
downloaded from an AS/400 system during the 
power-on process of a 3477, 3486, 3487 or 3488 device 
if the 3477, 3486, 3487 or 3488 device is attached to an 
ASCII printer. The new translate table replaces the 
3477, 3486, 3487 or 3488 existing translate table used 
for printers. See transiate table. 


programmable workstation (PWS). A workstation 
that can operate independently of an AS/400 system 
but can also communicate with an AS/400 system, for 
example a PC or PS/2 computer running PC 
Support/400. 


protocol. A set of instructions, requests, and 
responses providing a means of controlling the transfer 
of data between devices. 

PSID. NSMV Product Set ID. 

PSDN. Packet switched data network. 

PTI. Packet-type identifier. 

PTT. Post Telephone and Telegraph Administration. 
PU. Physical unit. 

public switched network (PSN). A communications 
facility owned by a telephone company through which 
subscribers can be connected by dialing the unique 
access number of another subscriber. 


PVC. Permanent virtual circuit. 


PWS. Programmable workstation. 


Q 


QLLC. Qualified logical link control. 
QRI. Queued response indicator. 


qualified fogical link control. A type of logical link 
control used in X.25 communications. 


QPSID. Query Product Set ID. 


R 


RA. Repeat to address. 

RAM. Random access memory. 

RD. Request disconnect or received data. 

Rec ADV. Record advance key. 

Rec Bs. Record backspace key. 

RECFMS. Record formatted maintenance statistics. 


Recommendation V.24. A recommendation for 
interfaces set by the CCITT and amended periodically. 
V.24 is a specification that defines the list of definitions 
for interchange circuits between data terminal 
equipment (DTE) and data circuit-terminating equipment 
(DCE). 


Recommendation V.25 bis. A recommendation for 
interfaces set by the CCITT and amended periodically. 
V series defines standards for interfaces and voice 
board modems. V.25 bis defines automatic calling and 
answering for the general switched telephone network 
using the 100-series interchange circuits. 


Recommendation V.28. A recommendation for 
interfaces set by the CCITT and amended periodically. 
Electrical characteristics for unbalanced double-current 
interchange circuits. (These characteristics are identical 
to those defined in ElA-232D.) 


Recommendation V.35. A recommendation for 
interfaces set by the CCITT and amended periodically. 
V.35 defines a communications interface composed of 
five single-ended interchange lines and separate 
differential lines for transmit data, transmit clock, receive 
data, and receive clock signals. 


Recommendation X.21. A recommendation for 
interfaces set by the CCITT and amended periodically. 
The X series of recommendations defines standards for 
data transmission interfaces. X.21, specifically, defines 
the interface between data terminal equipment and 
public data networks for digital leased and. 
circuit-switched synchronous services. 
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Recommendation X.25. A recommendation for 
interfaces set by the CCITT and amended periodically. 
The X series of recommendations defines standards for 
data transmission interfaces. X.25, specifically, defines 
the interface between data terminal equipment and 
packet switched networks. 


remote attachment. Attachment of workstations to an 
AS/400 system through communication lines, and 
usually through an intermediate 5494. 


remote data communications system. A computer 
system that communicates with one or more of its 


devices by means of a communications system such as — 


a telephone line, satellite system, or microwave device. 
remote loopback. A test procedure that verifies the 
operation of the local modem, the remote modem, and 
the communication lines between them. 


remote workstation. A workstation that is attached to 
the AS/400 system through communication lines. 


REQMS. Record maintenance status. 
REQTEST. Request test. 


reversed charging acceptance. This facility allows 
virtual calls to be billed to the DTE receiving the call. 


RFS. Ready-for-sending. 

RH. Request/response header. 

RI. Ring indicator. 

RIM. Request initialization mode. 
RJE. Remote job entry terminal. 
RLSD. Received line signal detected. 
RNR. Receive not ready. 

ROM. Read-only memory. 

ROS. Read-only storage. 

RPOA. Recognized Private Operating Agency. 
RPQ. Request for price quotation. 
RQD. Request definite response. 
RQE. Request exception response. 
RQN. Request no response. 

RQR. Recovery. 


RR. Receive ready. 
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RRI. Request/response indicator. 
RSP. Required space character. 
RSET. Received signal element timing. 
RSHUTD. Request shutdown. 

RTI. Response type indicator. 

RTM. Response time monitor. 

RTS. Request to send. 

RTR. Ready to receive. 

RU. Request/response unit. 


RX. Receive data. 


S 


SABM. Set asynchronous balanced mode. 

SAP. Service access point. 

SARM. Set asynchronous response mode. 

SBA. Set buffer address. 

SC. Session control. 

SCD. Set character density. 

SCL. Set CGCS through local ID. 

scroll bar drag and drop. An operation using a 
mouse that scrolls a list to view items not currently 
displayed, by moving the mouse cursor over the scroll 
bar beside the list. 

SCS. SNA character string. 

SDI. Sense data included indicator. 

SDLC. Synchronous Data Link Control. 

SDT. Start data traffic. | 

sense data. The data sent with an SNA negative 
response or provided with an SRC, indicating the 
reason for the problem. 

service access point. A logical point made available 
by an adapter where information can be received and 
transmitted. 

session control (SC). (1) In SNA, one of the 
components of transmission control. Session control is 


used to purge data flowing in a session after an 
unrecoverable error occurs, resynchronize the data flow 


~ after such an error, and perform cryptographic 
verification. (2) In SNA, an RU category used for 
requests and responses exchanged between the 
session control components of a session, and for 


session activation/deactivation requests and responses. 


SET. Signal element timing. 

SF. Start of field. 

SG. Signal ground. 

SGEA. Set graphic error action. 

SHF. Set horizontal format. 

Shift-in character (SI)... Ends double-byte character 
representation and returns to single-byte character 


representation on a screen. 


Shift-out characier (SO).. Starts double-byte 
character representation on the screen. 


SHM. Short Hold mode. 

SIM. Set initialization mode. 

SLD. Set line density. 

SLP. Selector light pen. 

SLU. Secondary logical unit. 

SNA. Systems Network Architecture. 

SNBU. Systems network backup. 

SNRM. Set Normal Response mode. 

SOH. Start of header. 

SRC. System reference code. 

SS. System services. 

SSCP. System services control point. 

station protector. A device used on the system cable 
to offer protection against lightning for attachments 
made in different buildings. 

STSN. Set and test sequence numbers. 

subarea node. A node that uses network addresses 
for routing and maintains routing tables that reflect the 
configuration of the network. Subarea nodes can 
provide gateway function to connect multiple subarea 
networks, intermediate routing function, and boundary 


function support for peripheral nodes. Type 4 and type 
5 nodes can be subarea nodes. 


subscription. An agreement between a user and a 
PTT/network supplier for the use of certain network 
services and optional facilities. 


SVC. Switched virtual circuit. 
SVF. Set vertical format. 


switched line. A connection between computers or 
devices that is established by dialing. 


switched virtual circuit (SVC). A switched virtual 
circuit is the packet switched service equivalent of a 
switched line. It allows communication between the 
5494 and one of several possible AS/400 systems. 


SYN. Synchronous idle character. 


synchronization character. The bit pattern used to 
identify the beginning of a message in 
character-oriented and byte-count-oriented protocols; 
also called synchronizing character and abbreviated 
SYN. 


Synchronous Data Link Control (SDLC). A form of 
communication line control used to transfer data over a 
communication line. 


synchronous operation. An operation that occurs 
regularly or predictably with respect to the occurrence of 
a specified event in another process. 


system configuration. A process that determines the 
devices, programs, and methods that form a data 
processing system. 

system generation. A procedure used to configure 
the AS/400 system for the particular options and 
functions chosen. 

system reference code (SRC). A code that contains 
information, such as a failing field replaceable unit, for a 
service representative. 

Systems Network Architecture (SNA). A set of rules 


for controlling the transfer of information in a data 
communications network. 


T 


TAC. Transmit activity check. 

TC. Transmission control. 

TD. Transmitted data or transparent data. 
telecommunications. The transmission of data 


between locations by telephone line, telegraph, radio, 
satellite, television, or microwave media. 
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telephone twisted-pair (TTP) cable. An unshielded 
cable with two or more pairs of insulated copper wire 
twisted together at a minimum of two twists per foot. 
This type of cable is commonly used in telephone 
installations for voice transmission. It can also be used 
for data transmission. However, twisted-pair cable is 
subject to interference and line loss, and therefore is 
limited to lengths of 305.8 m (1000 ft) when used to 
interconnect workstations to the 5494. Compare with 
twinaxial cable and IBM Cabling System. 


terminal multiconnector. A device used to connect 
up to seven workstations to a single port on the 5494. 
The IBM 5299 Terminal Multiconnector can be used 
when cable-thru is inappropriate or unavailable. 


TH. Transmission header. 
Ti. Inactivity timer. 
TIFF. Tag Image File Format (Aldus Corporation). 


Token-Ring network. A network using a ring topology 
to pass data transmission authority (called a token) ina 
unidirectional circuit from one workstation to another so 
that transmitted data not only reaches the addressed 
station but also returns to the transmitting station. 


translate table. A table that defines the translation of 
EBCDIC to ASCII and that allows the use of special 
characters and nonstandard codes. For KTT, it defines 
what EBCDIC character is displayed for a particular 
key. 


transmission header (TH). In SNA, control 
information optionally followed by a basic information 
unit (BIU) or by a BIU segment, that is created and 
used by path control to route message units and to 
control their flow within the network. 


Trim Magnify. A method of magnifying a portion of the 
image/fax. The user positions the mouse pointer on the 
image/fax, presses and holds the secondary mouse 
button, and moves the mouse pointer to define a portion 
of the image/fax. When the secondary mouse button is 
released, the “trimmed” portion is magnified using a 
higher scaling percentage. 

TRN. Transparent. 

TS. Transmission subsystem. 

TSET. Transmitted signal element timing. 

TTP. Telephone twisted-pair (cable). 

TW. Maximum out value. 

-twinaxial cable. A shielded cable with two conductors 


surrounded by insulating material and a conductive 
sleeve. It is used to pass information between devices 
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separated by up to 1524 m (5000 ft). Compare with 
telephone twisted-pair (TTP) cable and IBM Cabling 
System. 

T1. Response timer. 

T2. Acknowledgment timer. 


T2.1. Type 2.1 connection. 


TX. Transmit data. 


U 


UA. Unnumbered acknowledgment. 

unit address. The address used to define each 
remote workstation. This address is determined for the 
remote configuration (customer setup) and must be 
obtained for use by the AS/400 system. 


UI. Unnumbered information. 


V 


vertical redundancy check character. A character 
code used for error sensing and correction. 


viewport. A rectangular area within a 5250 session 
used to display image/fax data. 


virtual call. A call placed on a switched virtual circuit. 
virtual circuit. A logical connection between two 
DTEs, which enables them to exchange information 
according to a standard communication procedure with 
the sequence of information preserved. A virtual circuit 
occupies transmission capacity only when the data is 
actually being transmitted. 

V.24. See Recommendation V.24. 

V.28. See Recommendation V.28 

V.25 bis. See Recommendation V.25 bis. 


V.35. See Recommendation V.35. 


W 


WCC. Write-to-display contro! character. 

WDSF. Write-to-Display Structured Field. 

WEA. Write extended attribute. 

window communications. The maximum number of 


packets that the DTE is authorized to transmit and have 
outstanding at any given time. It is the basic flow 


control mechanism in X.25 and protects the network 
from accepting packets faster than they can be 
accepted by the remote DTE. The window can also be 
used by a DTE to prevent transmission of packets from 
the network if the DTE is unable to queue them. A 
default window size, usually 2, is assigned at 
subscription time. In some networks, this can be 
altered for a given virtual call. 


window graphics. An area on the screen that 
generally has borders and that overlays other areas of a 
screen. 


workstation. An input/output device that allows either 
the transmission of data and the reception of data (or 
both) from the 5494 or AS/400 system, as needed to do 
a job. A workstation is either a display station or a 
printer. 


workstation address. The address set by the 
operator during setup of the workstations. This address 
may be set on rocker switches, by keyboard entry, or by 
control panel entry. 


World Trade. Any of the countries in Europe, Asia, 
Africa, and South America served by IBM. 


WP. Word processing. 

WSC. Workstation customization support. 
WSF. Write structured field. 

WSSF. Write single structured field. 


WTD. Write to display. 


X 


X' '. Hexadecimal number in single quotes. 

X.21. See Recommendation X.21. 

X.21 bis DCE. A type of data circuit-terminating © 
equipment that converts signals between EIA signal 
lines and those associated with an X.21 interface. 
X.25. See Recommendation X.25. 


XID. Exchange station identification. 


XMIT. Transmit. 


Z 


zero-bit. A bit with a voltage that represents a value of 
0. 


zero-bit insertion/deletion. A communications plan 
which prevents more than six 1-bits from being 


transmitted (including the flag), by inserting a 0 after 
each sixth 1-bit. 


Special Characters 


+rsp. Positive response. 


-rsp. Negative response. 
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Index 


Numerics 
3270 keyboard functions 16-14 
cursor select 16-15 
erase EOF 16-14 
field mark 16-15 
PA 1-3 16-15 
5250 data stream commands, unsupported B-1 
5250 QUERY command 15-133 
5250 Video Delivery xxix, 15-4, 15-113, 
15-127—15-130 
5250 WSC CUSTOMIZATION command 15-118 
5494 
description 1-1 
interfaces 
EIA 232D 14-1, 19-1 
V.35 19-8 
X.21 1-2, 19-5 
introduction 1-1 


A 


activating the RTM 14-3 
ACTLU 13-18 
command format 13-18 
response format 13-18 
address call 
V.25 bis 5-2 
X.21 switched 4-2 
address field (SDLC) 2-5 
addressing, LAPB 3-3 
AID codes 16-5 
AlD-generating keys 
clear 16-6 
codes 16-5 
command function keys 16-7, A-14 
enter/rec adv 16-6 
help 16-7 
print 16-7 
record backspace (home) 16-7, A-14 
rolldown 16-7 
rollup 16-7 
alert messages 14-1 
alpha shift key 16-11 
alphanumeric mode_ A-1 
alternate cursor key 16-11 
alternate entry A-2 
AS/400 system extended ideographic support 
LOAD MATRIX command, definition A-12 
LOAD MATRIX command, processing A-12 
attention key 16-8 
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B 
BIND 
command format 
for printers 13-20 
for workstation 13-19 
handling 12-2 
border presentation minor structure 15-37 


C 


call clearing 

V.25 bis 5-2 

X.21 switched 4-2 
call collision 

incoming call packet 3-9 
call collisions 

V.25 bis 5-5 

X.21 switched 4-7 
call connected 3-8 
call placement 

V.25 bis 5-2 

X.21 switched 4-2 

X.25 3-14 


_ Cail progress signals 4-7 


call request 3-9 


calls 
clearing 4-2 
direct 4-2 
normal 4-2 


CANCEL command 13-22 
choice selection indicators 15-82 
Circuit conditions 4-5 
CLEAR FORMAT TABLE command 15-5, A-5 
clear key 16-6 
CLEAR UNIT ALTERNATE command 15-5 
CLEAR UNIT command 15-4, A-5 
command function keys 16-7, A-14 
command mode _ 16-2 
commands 
display data streams A-4 
5250 QUERY 15-133 
5250 WSC CUSTOMIZATION 15-118 
CLEAR FORMAT TABLE 15-5, A-5 
CLEAR UNIT 15-4, A-5 
CLEAR UNIT ALTERNATE 15-5 
COPY-TO-PRINTER 15-154 
IMAGE/FAX CONTROL 15-120 
IMAGE/FAX DOWNLOAD — 15-126 
READ IMMEDIATE 15-112 
READ INPUT FIELDS 15-105 
READ MDT ALTERNATE 15-107 
READ MDT FIELDS 15-106, A-4 
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commands (continued) 
display data streams (continued) 
READ MODIFIED IMMEDIATE 
ALTERNATE 15-112 
READ SCREEN 15-107, A-4 
READ SCREEN TO PRINT 15-109 
READ SCREEN TO PRINT WITH EXTENDED 
ATTRIBUTES 15-109 
READ SCREEN TO PRINT WITH EXTENDED 
ATTRIBUTES AND GRID LINES 15-111 
READ SCREEN WITH EXTENDED 
ATTRIBUTES 15-108 
RESTORE PARTIAL SCREEN 15-116 
RESTORE SCREEN 15-116, A-5 
ROLL 15-117, A-5 
SAVE A-4 
SAVE PARTIAL SCREEN 15-114 
~SAVE SCREEN 15-113 
WRITE ERROR CODE 15-103, A-5 
WRITE ERROR CODE TO WINDOW 15-104 
WRITE SINGLE STRUCTURED FIELD 15-118 
WRITE STRUCTURED FIELD 15-130 
WRITE TO DISPLAY 15-6, A-6 
LAPB 3-3 | 
printer 
READ MULTIPLE STATUS 18-1 
RESET MULTIPLE STATUS 18-1 
SDLC 2-7 
FRMR 2-8 
information frames 2-7 
supervisory 2-7 
TEST 2-8 
timeout error recovery 2-9 
unnumbered 2-7 
XID 2-8 
SNA 
ACTLU 13-18 
BIND 13-18 
CANCEL 13-22 
DACTLU 13-22 
LUSTAT 13-23 
RECFMS 13-25 
REQMS_ 13-28 
REQTEST 13-24 
RSHUTD 13-28 
SIGNAL 13-28 
UNBIND 13-29 
STRPFRMON_ 14-3 
TEST 2-8 
text support 
DEFINE AUDIT WINDOW TABLE 15-140 
DEFINE COMMAND KEY FUNCTION 15-141 
DEFINE FAKE DP COMMAND KEY 
FUNCTION 15-153 
DEFINE OPERATOR ERROR 
MESSAGES 15-152 
DEFINE PENDING OPERATIONS 15-144 
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commands (continued) 
text support (continued) 
DEFINE PITCH TABLE 15-152 
DEFINE SCALE LINE 15-146 
DEFINE SPECIAL CHARACTERS 15-150 
DEFINE TEXT SCREEN FORMAT 15-144 
PENDING DATA (response) 15-150 
READ TEXT SCREEN 15-142 
WRITE TEXT SCREEN 15-147 
communication protocols 
alerts 14-1 
SDLC 1-1, 2-1 
SNA 14-1 
Token-Ring 1-1, 6-1 
V.35 19-8 
X.21 4-1 
X.25 1-1, 3-1 
communications codes 4-4 
concurrent host attachment xxix, 1-1, 6-9, 9-1, 10-1, 
14-1 
configuration 
Token-Ring AS/400 Attachment 1-3 
Token-Ring Gateway 1-3, 6-1 
connection sequence, switched line 2-3 
Continued Entry Fields 15-24 
control characters 
WRITE TO DISPLAY 15-8 
control field (SDLC) 2-6 
copy and paste function 17-1 
COPY-TO-PRINTER command 15-154 
create window major structure parameters 15-36 
CREATE WINDOW structured field 15-34, 15-39 
Cursor Progression Entry Field 15-30 
cursor select key 16-15 
cursor-sensitive scrolling 15-86 


D 
DACTLU command 13-22 
data characters 15-10 
data entry 
alternate entry A-2 
double-byte direct entry A-2 
data mode 16-2 
data processing (DP) mode 15-2 
DCE support 2-2 
DCE-clear-confirmation 4-6 
DCE-controlled-not-ready 4-7 
DEFINE AUDIT WINDOW TABLE command 15-140 
DEFINE COMMAND KEY FUNCTION 
command 15-141 
DEFINE OPERATOR ERROR MESSAGES 
command 15-152 
DEFINE PENDING OPERATIONS command 15-144 
DEFINE PITCH TABLE command 15-152 


DEFINE SCALE LINE command 15-146 
define scroll bar field structured field 15-88 
DEFINE SELECTION FIELD command 15-44 
define selection field major structure 15-46 
DEFINE SPECIAL CHARACTERS command 15-150 
DEFINE TEXT SCREEN FORMAT command 15-144 
delete key 16-9 
display data streams 15-1 
commands 15-3 
5250 QUERY 15-133 
5250 WSC CUSTOMIZATION 15-118 
CLEAR FORMAT TABLE 15-5 
CLEAR UNIT 15-4 
CLEAR UNIT ALTERNATE 15-5 
IMAGE/FAX CONTROL 15-120 
IMAGE/FAX DOWNLOAD 15-126 
PENDING DATA (response) 15-150 
READ IMMEDIATE 15-112 
READ INPUT FIELDS 15-105 
READ MDT ALTERNATE 15-107 
READ MDT FIELDS 15-106 
READ MODIFIED IMMEDIATE 
ALTERNATE 15-112 
READ SCREEN 15-107 
READ SCREEN TO PRINT 15-109 
READ SCREEN TO PRINT WITH EXTENDED 
ATTRIBUTES 15-109 
READ SCREEN TO PRINT WITH EXTENDED 
ATTRIBUTES AND GRID LINES 15-111 
READ SCREEN WITH EXTENDED 
ATTRIBUTES 15-108 
RESTORE PARTIAL SCREEN 15-116 
RESTORE SCREEN 15-116 
ROLL 15-117 
SAVE PARTIAL SCREEN 15-114 
SAVE SCREEN 15-113 
WRITE ERROR CODE 15-103 
WRITE ERROR CODE TO WINDOW 15-104 
WRITE SINGLE STRUCTURED FIELD 15-118 
WRITE STRUCTURED FIELD 15-130 
WRITE TO DISPLAY 15-6 
introduction 15-1 
LU-LU 15-2 
data processing (DP) mode 15-2 
pass-through data stream processing 15-3 
word processing (WP) mode 15-3 
pass-through support 15-132 
SS-LU 15-1 
text support 15-140 
DEFINE AUDIT WINDOW TABLE 15-140 
DEFINE COMMAND KEY FUNCTION 15-141 
DEFINE FAKE DP COMMAND KEY 
FUNCTION 15-153 
DEFINE OPERATOR ERROR 
MESSAGES 15-152 
DEFINE PENDING OPERATIONS 15-144 
DEFINE PITCH TABLE 15-152 


display data streams (continued) 
text support (continued) 

DEFINE SCALE LINE 15-146 
DEFINE SPECIAL CHARACTERS 15-150 
DEFINE TEXT SCREEN FORMAT 15-144 
READ TEXT SCREEN 15-142 
WRITE TEXT SCREEN 15-147 

display mode key sequence 16-9 

Display Pointer Device (Mouse) support functions 17-1 

dual keyboard support 16-15 

duplex 2-1 


E 


echo suppressor 2-3 
editing keys used in selection fields 15-87 
EIA 232D 
cable wrap 19-5 
EIA 232D interface 
lines between DTE and DCE 19-1 
signal lines 19-3 
“either” fields A-6, A-8 
ending flag (SDLC) 2-6 
enter/rec adv key 16-6 
erase EOF key 16-14 
erase input key 16-9 
erase to address order 15-12 
error information, SNA alert 14-1 
error log 
entry format 13-26 
REQMS command 13-28 
error reporting, SDLC 2-9 
error reset key 16-9 
Ethernet 
LAN AS/400 Attachment configuration 
alternate AS/400 system support 6-9 
error logging 6-9 
initialization 6-7 
parameters 6-9 
LAN Gateway configuration 
error logging 6-6 
initialization 6-2 
parameters 6-3 
LAN management 6-11 
overview 6-1 
statistics and logs 6-10 
event processing specifics 17-3 
extended graphics - layer 100 16-14 


F 
facilities, X.21 4-1 
field attributes 15-32 
for acolor display 15-32 
for anon-color display 15-32 
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field control word 15-21 
field format word 15-18 
field formats 15-19 
field length 15-33, 15-34 
field mark key 16-15 | 
field presentation parameters 15-54 
fields, SDLC 
address 2-5 
control 2-6 
information 2-6 
flag, SDLC 
ending 2-6 
starting 2-5 
FM profile 7 13-11 
format 
levelO A-11 
NMVT RU 14-4 
SNA alerts, of 
forward edge trigger field control word 15-23 
frame check sequence (SDLC) 2-6 
frame relay xxix, 1-2, 1-3, 7-1—7-5 
frame, SDLC 2-5 
address field 2-5 
control field 2-6 
ending flag 2-6 
frame check sequence 2-6 
information field 2-6 
leading pad 2-5 
starting flag 2-5 
FRMR command 2-8 
function management profile 13-11 


G 


general format identifier (GFI) 3-6 


H 

half-duplex 2-1 

help (from error state) key 16-8 
help key 16-7 

hex key 16-10 

highlighted entry field 15-31 
home key 16-10 

hot spot function 17-1, 17-2 


l-frame 2-8 
ideographic enhancements 
alphanumeric mode A-1 
AS/400 system support A-11 
display data streams A-3 
double-byte and single-byte characters A-1 
ideographic mode A-2 
keyboard functions A-13 
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ideographic enhancements (continued) 
SNA support A-3 
IMAGE/FAX CONTROL command 15-120 
IMAGE/FAX DOWNLOAD command 15-126 
inbound scroll bar field data 15-92 
inbound selection field data 15-67 
inbound window field data 15-41 
information field (SDLC) 2-6 
information frames 2-7 
insert cursor order 15-11 
insert key 16-10. 
insert mode 16-2 
intelligent printer data streams (IPDS) 18-1 
interface states 
V.25 bis 5-4 
X.21 4-8 
interfaces 
and control unit model 1-2 
and network type 1-2 
EIA 232D 
connector mechanical information 19-4 
lines between DTE and DCE 19-1 
physical 1-1 
signal lines 19-3 
Token-Ring 
physical 1-1 
wall connector 19-13 
wiring concentrator 19-16 
V.25 bis 
physical 1-1 
V.35 
Connector mechanical information 19-11 
lines between DTE and DCE 19-8 


physical 1-1 
signal lines 19-10 
X.21 


connector mechanical information 19-7 
lines between DTE and DCE 19-5 
physical 1-1 

signal lines 19-6 


K 


keyboard functions 16-1, A-13 

keyboard modes. 16-1 
command mode _ 16-2 
data mode 16-2 
insert mode 16-2 

keyboard states 16-1 
hardware error state 16-1 
normal locked state 16-1 
normal unlocked state 16-2 
post-help error state 16-3 
power-on state 16-3 
pre-help error state 16-3 
SS message state 16-3 


keyboard states (continued) 
system request state 16-4 
keys 16-4 
3270 functions 16-14 
AlD-generating 16-4 
diacritic 16-12 
signal 16-8 
special control 16-9 
special function 16-11 


L 
LAPB 
addressing 3-3 
command 3-3 
frame format 3-3 
leading pad 2-5 
Light pen function 17-3 
link access protocol-balanced (LAPB) 
addressing 3-3 
description 3-2 
link access-protocol balanced (LAPB) 
commands and responses 3-3 
link initialization and reconnection 3-4 
link-level procedures 3-2 
LOAD MATRIX 
logical channel identifier (LCI) 3-7 
logical channels 
disconnecting a circuit 3-14 
opening a PVC 3-14 
SVC call answering 3-14 
SVC call placement 3-14 
logical link control 3-13 
logical units (LU) 13-10 
LU 4 and LU 7 
negative responses 13-30 
support 13-10 
LU 4 and LU 7 LU-LU session data stream 
formats 15-2 
LU 6.2 
negative responses 13-9 
path information units (PIU) 
support 13-1 
transmission header 13-3 
LUSTAT command 13-23, A-3 


magnetic stripe reader 15-21 
mnemonic selection 15-84 
modes 
alphanumeric A-1 
ideographic A-2 
modulo 128 
and Data packet 3-12 


modulo 8 

and Data packet 3-12 
mouse 

See pointer device 
Mouse Button Event exceptions 17-3 
Mouse Function overview 

Copy and paste function 17-1 

Hot Spot function 17-1 

Light Pen function 17-1 

Scroll Bar Drag and Drop function 17-1 
mouse selection entry field 15-32 
move cursor order 15-12 
multiple window levels 15-41 


N 


negative responses 13-30 
data stream 13-30 
devices and cable error 13-30 
SNA session 13-30 
network addressable units (NAUs) 
logical units (LU) 13-10 
physical units (PU) 13-10 
system services control point (SSCP) 13-10 
networks 
See also communication protocols 
operator interface 2-2 
X.21 considerations 2-4 
NMVT RU format 14-4 
nonprogrammable workstation support 
operations 
bring-down 10-3 
bring-up 10-2 
error recovery 10-3 
session 
5494 to AS/400 system, activating 10-2 
limits, initializing 10-2 
workstation to 5494, activating 10-3 
normal disconnected mode 2-9 


-normal response mode 2-9 


numeric shift key 16-11 
NWS support 
See nonprogrammable workstation support 


only fields A-6, A-8 
open fields A-6, A-9 
operator network interface 2-2 


P 
PA 1-3 keys 16-15 
packet data field 3-7 
packet structure (X.25) 3-6. 
general format identifier (GFI) 3-6 
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packet structure (X.25) (continued) 
logical channel identifier 3-7 
packet data field 3-7 
packet type identifier 3-7 - 
packet type identifier 3-7 
packet types, not supported 3-7 
packet types, supported 3-7 
packet-level commands 
operator call answering 3-14 
operator call placement 3-14 
packet-level functions 
call clearing 
DCE clear indication 3-9 
DTE clear collision 3-10 
DTE clear confirmation 3-9 
DTE clear request 3-9 
call establishment 
call accepted 3-8 
call connected 3-8 
call request 3-9 
incoming call 3-8 
information transfer 
Data packet 3-11 
receive not ready packet 3-11 
receive ready packet 3-11 
reset 
DCE reset indication 3-11 
DTE reset request 3-11 
reset collision 3-11 
restart 3-10 
DCE restart indication 3-10 
DTE restart request 3-10 
restart collision 3-10 
packet-level procedures 3-5 
pass-through data stream processing 15-3 
pass-through display support 15-132 
path information units (PIU) 13-12 
fields 
request/response header (RH) 13-3, 13-13 
transmission header (TH) 13-3, 13-12 
SDLC 13-12 
PENDING DATA response’ 15-150 
performance information 14-3 
permanent alerts 14-2 
permanent virtual circuit (PVC) 3-5 
physical units (PU) 13-10 
pointer device 17-1 
post-help error state 16-3 
power-on state 16-3 
pre-help error state 16-3 
presenting selection field choices 15-68 
print key 16-7 
printer data streams 18-1 
printers, ideographic, supported 
program access keys 
See PA 1-3 keys 
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programmable mouse buttons event definitions 15-97 
programmable mouse buttons format of major 
structure 15-95 
programmable mouse buttons major structure 15-95 
programmable mouse buttons operations 15-98 
programmable mouse buttons parameters 15-97 
PROGRAMMABLE MOUSE BUTTONS structured 
field 15-95 | 
programmable workstation support 
alert forwarding 12-3 
pass-thru function 12-1 
session 
addressing 12-1 
tracking 12-3 
PVC, opening 3-14 
PWS support 
See programmable workstation support 


Q 


QUERY command 15-133 


R | 
READ IMMEDIATE command 15-112 
READ INPUT FIELDS command 15-105 
format 15-105 
READ MDT ALTERNATE command 15-107 
READ MDT FIELDS command 15-106, A-4 
READ MODIFIED IMMEDIATE ALTERNATE 
command 15-112 
READ MULTIPLE STATUS command 18-1 
READ SCREEN command 15-107, A-4 
READ SCREEN TO PRINT command 15-109 
READ SCREEN TO PRINT WITH EXTENDED 
ATTRIBUTES AND GRID LINES command 15-111 
READ SCREEN TO PRINT WITH EXTENDED 
ATTRIBUTES command 15-109 
READ SCREEN WITH EXTENDED ATTRIBUTES 
command 15-108 
READ TEXT SCREEN command. 15-142 
RECFMS command 13-25 
counter formats 13-26 
type 1. 13-25 
record backspace (home) key 16-7, A-14 
REMOVE ALL GUI CONSTRUCTS structured 
field 15-43 
remove GUI scroll bar field major structure 15-92 
REMOVE GUI SCROLL BAR FIELD structured 
field 15-92 
REMOVE GUI SELECTION FIELD structured 
field 15-87 
REMOVE GUI WINDOW structured field 15-42 
repeat to address order 15-12 
REQMS command 13-28 


REQTEST command 13-24 
request/response header 13-3, 13-13 
resequencing 15-21, 15-22 
RESET MULTIPLE STATUS 18-1 
Response Time Monitor features with the 5494 
activating 14-3 
description 14-3 
exceptions 14-4 
RESTORE PARTIAL SCREEN command 15-116 
RESTORE SCREEN command 15-116, A-5 
retraining sequences 2-2 
RNR packet 
See packet-level functions, information transfer, 
receive not ready packet 
ROLL command 15-117, A-5 
roll keys 16-7 
RR packet 
See packet-level functions, information transfer, 
receive ready packet 
RSHUTD command 13-28 
RTM 
See Response Time Monitor features with the 5494 


S 


SAVE command A-4 
SAVE PARTIAL SCREEN command 15-114 
SAVE SCREEN command 15-113 
scroll bar drag and drop function 17-1 
mouse event processing specifics 17-1 
SDLC | 
See also synchronous data link control 
commands 2-7 
FRMR 2-8 
information frames 2-7 
Supervisory 2-7 
TEST 2-8 
timeout error recovery 2-9 
unnumbered 2-7 
XID 2-8 
data transmission 2-4 
frame format 2-5 
address field 2-5 
control field 2-6 
ending flag 2-6 
frame check sequence 2-6 
information field 2-6 
leading pad 2-5 
starting flag 2-5 
implementation 2-1 
information frames 2-8 
modes, operating 2-9 
normal disconnected mode 2-9 
normal response mode 2-9 
switched link operations 2-2 


SDLC modes, operating 2-9 
selection field minor structures 15-56 
selection field presentation 15-68 
selection fields 15-84 
selector light pen 15-21, 15-23 
self-check 15-21 
Sessions 
Host-initiated 12-2 
set buffer address order 15-11 
shift keys 16-10 
Short Hold mode 4-3 
retries 4-3 
XID format 4-3 
SIGNAL command 13-28 
signal keys 16-8 
attention 16-8 
help (from error state) 16-8 
single- and double-digit numeric selection 15-85 
SNA 13-1 
See also systems network architecture 
character strings 18-1 
command summary 13-17 
commands 13-16 
ACTLU 13-18 
BIND 13-18 
CANCEL 13-22 
DACTLU 13-22 
LUSTAT 13-23 
RECFMS 13-25 
REQMS 13-28 
REQTEST 13-24 
RSHUTD 13-28 
SIGNAL 13-28 
UNBIND 13-29 
function management profile 13-11 
implementation 13-1 
network addressable units (NAUs) 
logical units (LU) 13-10 
physical units (PU) 13-10 
system services control point (SSCP) 13-10 
path information units (PIU) 13-12 
SDLC 13-12 
request/response header 13-3, 13-13 
subarea network 9-1 
transmission header 13-3, 13-12 
transmission services profile 13-11 
special AS/400 system keys 16-11 
special control keys 16-9 
alpha shift 16-11 
delete 16-9 
display mode sequence 16-9 
erase input 16-9 
error reset 16-9 
hex 16-10 
home 16-10 
insert 16-10 
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special control keys (continued) — 
numeric shift 16-11 
shift 16-10 
SRCs 
See system reference codes 
SS message state 16-3 
SS-LU session data streams 15-1 
start of field order 15-17 
field attributes 15-32 
for a color display 15-32 
for a non-color display 15-32 
field control word 15-21 
field format word 15-18 
field length 15-33, 15-34 
start of header order 15-13 
Start Performance Monitor command 14-3 
starting flag (SDLC) 2-5 
status aids 
image/fax 15-125 
supervisory commands 2-7 
SVC call answering 3-14 
SVC call placement 3-14 
switched line 
connection sequence 2-3 
disconnection 2-3 
switched link operations (SDLC) 2-2 
switched virtual circuit (SVC) 3-5 
synchronous data link control 
error reporting 2-9 
leased 2-1 
switched 2-1 
sys req key 16-11 
system reference codes 14-1 
system request state 16-4 
system services control point (SSCP) 13-10 
systems network architecture 
alert 
descriptions 
format 14-2 
forwarding 14-3 
function 14-1 
operation 14-1 
_ types 
LU 4 and LU 7 
negative responses 13-30 
support 13-10 
LU 6.2 
negative responses 13-9 
support 13-1 
RTM features 
activating 14-3 
description 14-3 
exceptions 14-4 
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T 
TEST command 2-8 
test request key sequence 16-12 
text support data streams 15-140 
DEFINE AUDIT WINDOW TABLE 15-140 
DEFINE COMMAND KEY FUNCTION 15-141 
DEFINE FAKE DP COMMAND KEY FUNCTION 
command 15-153 
DEFINE OPERATOR ERROR MESSAGES __ 15-152 
DEFINE PENDING OPERATIONS 15-144 
DEFINE PITCH TABLE 15-152 
DEFINE SCALE LINE 15-146 
DEFINE SPECIAL CHARACTERS 15-150 
DEFINE TEXT SCREEN FORMAT 15-144 
PENDING DATA (response) 15-150 
READ TEXT SCREEN 15-142 
WRITE TEXT SCREEN 15-147 
timeout conditions, X.21 switched 
call collisions 4-7 
call progress signals 4-7 
DCE-clear-confirmation 4-6 
DCE-controlled-not-ready 4-7 
Token-Ring AS/400 Attachment configuration 1-3, 6-7 
Token-Ring Gateway configuration 1-3, 6-1 
Token-Ring support 6-1 
LAN management 6-11 
overview 6-1 
statistics and logs 6-10 
Token-Ring AS/400 Attachment configuration 6-7 
alternate AS/400 system support 6-9 
error logging and recovery 6-9 
initialization 6-7 
link establishment 6-7 
parameters 6-9 
Token-Ring Gateway configuration 
alerts | 
error logging and recovery 6-6 
initialization 6-2 
link establishment 6-2 
parameters 6-3 
transmission encoding 2-2 
transmission encoding, V.25 bis 5-5 
transmission header 13-3, 13-12 
transmission services profile 13-11 
transparency field control word 15-23 
transparent data order 15-14 
TS profile 7 13-11 
twinaxial device errors 14-2 
Type 2.1 node support 8-1 
XID command 8-2 
type-ahead function 16-13 


U 

UNBIND command 13-29 

unnumbered commands 2-7 

UNRESTRICTED WINDOW CURSOR MOVEMENT 
structured field 15-42 

unsolicited performance information 14-4 


V 
V.25 bis 5-1 
commands 5-2 
facilities, supported 5-1 
indications 5-3 
interface states 5-4 
call collision 5-5 
call-connected 5-5 
DTE to DCE dialog 5-4 
incoming calls 5-5 
initial condition 5-4 
outgoing calls 5-5 
operator network interface 
address call 5-2 
call clearing 5-2 
call retries 5-2 
V.35 
cable wrap 19-12 
lines between DTE and DCE 19-8 
signal levels 19-11 
signal lines 19-10 


WwW 


window title/footer minor structure 15-38 
word processing (WP) mode_ 15-3 
Word Wrap Entry Fields 15-28 
workstations, supported 
WRITE DATA Structured Field 15-93 
WRITE ERROR CODE command 15-103, A-5 
WRITE ERROR CODE TO WINDOW 
command 15-104 
write extended attribute order 15-14 
WRITE SINGLE STRUCTURED FIELD 
command 15-118 
WRITE STRUCTURED FIELD command 15-130 
WRITE TEXT SCREEN command 15-147 
WRITE TO DISPLAY command 15-6, A-6 
control characters 15-8 
parameters 

erase to address order 15-12 

insert cursor order 15-11 

move cursor order 15-12 

repeat to address order 15-12 

set buffer address order 15-11 

start of field order 15-17 

start of header order 15-13 

transparent data order 15-14 

write extended attribute order 15-14 


WRITE TO DISPLAY command (continued) 
parameters (continued) 
WRITE TO DISPLAY structured field 
Order 15-34 
WRITE TO DISPLAY structured field order 15-34 


X 
X.21 
cable wrap 19-8 
call collisions 4-7 
circuit-switched support 4-1 
DCE clear confirmation 4-6 
DCE-controlled-not-ready 4-7 
facilities 4-1 
interface states 
diagrams 4-8 
network considerations 2-4 
network facilities 4-1 
network states 4-5 
initial conditions 4-5 
receive conditions 4-5 
transmit conditions 4-6 
overview 4-1 
Short Hold mode 4-3 
supported functions 4-1 
X.21 interface, signal lines 19-6 
X.21 operator network interface 
address call 4-2 
call clearing 4-2 
direct call 4-2 
X.21 switched 
call clearing 
changing subscription parameters 4-1 
communications codes 4-4 
timeout conditions 4-6 
transmit conditions 4-6 
X.25 
functional support 3-1 
implementation 3-1 
link level 3-2 
logical channels 
disconnecting a circuit 3-14 
opening a PVC 3-14 
SVC call answering 3-14 
SVC call placement 3-14 
logical link control 3-13 
optional facilities 3-2 
packet structure 3-6 
general format identifier (GFI) 3-6 
logical channel identifier 3-7 
packet data field 3-7 
packet type identifier 3-7 
packet types 3-/ 
packet-level procedures 3-5 
permanent virtual circuit (PVC) 3-5 
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X.25 (continued) 

physical level 3-2 

switched virtual circuit (SVC) 3-5 
XID command 2-8 


Z 


zero-bit insertion 2-2 
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